agentkit-seo-wiki-maintenance

AgentKit SEO Wiki Maintenance

Overview

Use this maintainer-only skill to keep AgentKit SEO wiki/knowledge.md, hub/<module>/sources.md, human-facing hub playbooks, and runtime skill guidance aligned with official sources.

This skill is for repository maintainers working from a local clone. It is never exported to user installs. End users receive static, pre-authored wiki entries through the package install flow.

Wiki context

• Always read [.skills/agent-skill/agentkit-seo/wiki/agentkit-seo.md](../agentkit-seo/wiki/agentkit-seo.md) before running any maintenance task so the agent understands the full project architecture before touching any file.
• If the root wiki entry is unavailable, read [.skills/agent-skill/agentkit-seo/SKILL.md](../agentkit-seo/SKILL.md), [.skills/architecture.md](../../architecture.md), and [MAINTAINING.md](../../../MAINTAINING.md) before proceeding. State that the root wiki entry was unavailable.

Allowed modules

Use only these module ids:

• agent-context-optimization
• cv-ats
• github
• linkedin
• web-portfolio
• x-twitter

Map each module id to its runtime skill folder:

| Module id | Runtime skill folder | |---|---| | agent-context-optimization | .skills/agent-skill/agentkit-seo-agent-context-optimization/ | | cv-ats | .skills/agent-skill/agentkit-seo-cv-ats/ | | github | .skills/agent-skill/agentkit-seo-github/ | | linkedin | .skills/agent-skill/agentkit-seo-linkedin/ | | web-portfolio | .skills/agent-skill/agentkit-seo-web-portfolio/ | | x-twitter | .skills/agent-skill/agentkit-seo-x-twitter/ |

Source handling rules

Apply the source quality rules from [MAINTAINING.md](../../../MAINTAINING.md) exactly:

• stable: Official platform documentation, official help-center pages describing system behavior, official engineering or product blogs, published specs, RFC-style documents, or official maintainer-published repositories.
• likely: Official sources that describe current behavior but depend on product tiers, UI state, geography, rollout status, undocumented implementation details, or provider-specific support.
• inferred: Official source code snapshots, architecture writeups, discontinued or historical official material, or repo-owned methodology where no external platform source exists.
• disputed: Conflicting official sources, unsupported public narratives, secondary commentary, or behavior where no clean official source exists.

When tools allow network access, search for newer or missing official sources before treating the current sources.md list as complete. Accept only official platform documentation, official help-center pages, official engineering or product blogs, published specs, RFC-style documents, or official maintainer-published repositories. Do not add secondary commentary, influencer posts, SEO agency articles, community speculation, Reddit threads, or login-gated material as source evidence.

Never introduce a source that does not meet the inclusion bar. Never upgrade inferred to stable without an explicit official source. Record every fetch and discovery check with URL, fetch date, determinable source changes, and affected wiki claims.

Patch output rules

Before writing any file, present a proposed patch and ask for explicit maintainer confirmation.

Every proposed change must include:

• Exact current text in knowledge.md or sources.md.
• Proposed replacement text.
• Source URL that justifies the change.
• Confidence label before and after the change.
• Reason: new evidence, source updated, source removed, conflicting sources, or confidence correction.

Never propose a change without source justification. If no official source supports a proposed wiki change, flag the claim for downgrade or further review instead of writing it as stable guidance.

File boundaries

On confirmation only, this skill may touch:

• .skills/agent-skill/agentkit-seo-<module>/wiki/knowledge.md
• .skills/agent-skill/agentkit-seo-<module>/wiki/index.md when source changes require a different conditional load map
• .skills/agent-skill/agentkit-seo-<module>/SKILL.md when source changes require different routing, load, or high-level operating rules
• .skills/agent-skill/agentkit-seo-<module>/references/*.md
• hub/<module>/sources.md
• hub/<module>/*.md
• llms-full.txt

This skill must never touch:

• llms.txt
• README.md
• Provider mirrors under skills/ or commands/
• Files outside the confirmed list above

Every downstream edit must be source-backed and module-scoped. Do not change hub playbooks, runtime references, module SKILL.md, or wiki/index.md only because the wording could be cleaner. Change them only when official evidence invalidates, narrows, expands, or clarifies the methodology that agents or humans should apply.

If a source change implies that a forbidden file should change, do not edit that file. Flag it in a follow-up section with the exact file, affected section when known, reason, and source URL. This applies to project-level README content, CHANGELOG entries, provider mirrors, provider wrappers, install behavior, and files outside the target module.

Mode 1: Single module refresh

Use this mode when the maintainer asks:

Use agentkit-seo-wiki-maintenance to refresh the <module> module

Workflow:

1. Read hub/<module>/sources.md to identify official sources for the surface.
2. Read .skills/agent-skill/agentkit-seo-<module>/wiki/knowledge.md to understand current claims, confidence labels, last_reviewed, and review_by.
3. Search for newer or missing official sources for the same surface. Use source discovery queries that target official domains, specs, help centers, engineering blogs, or maintainer-published repositories. Reject secondary or speculative material.
4. Fetch every official source in sources.md that is newer than last_reviewed, plus any newly discovered official source that meets the inclusion bar. If last_reviewed is more than 30 days ago, fetch all official sources regardless of the stated review interval.
5. Extract source-backed claims relevant to the module surface.
6. Diff extracted claims against current knowledge.md:
7. New claims supported by official sources that are absent from the wiki.
8. Existing claims whose confidence should change based on current source text.
9. Claims the source no longer supports, flagged for removal or downgrade.
10. Claims contradicted by a conflicting official source, marked disputed.
11. Inspect downstream module files that may need aligned updates: hub/<module>/.md, .skills/agent-skill/agentkit-seo-<module>/references/.md, .skills/agent-skill/agentkit-seo-<module>/SKILL.md, and .skills/agent-skill/agentkit-seo-<module>/wiki/index.md.
12. Diff extracted claims against downstream module guidance:
13. Hub playbook claims that should change because official evidence changed.
14. Runtime reference instructions that should change because agents would otherwise apply stale methodology.
15. Module SKILL.md routing, source hierarchy, or load rules that should change because the module's operating model changed.
16. wiki/index.md load rules that should change because new wiki knowledge should be loaded for different tasks.
17. Identify forbidden files that still need separate follow-up outside this skill's write permissions, including README, CHANGELOG, provider wrappers, generated provider mirrors, install behavior, or files outside the target module.
18. Produce a proposed patch with exact line-level edits to every touched allowed file and source URL justification for every change.
19. Present the full proposed patch and the forbidden-file follow-up list before writing anything. Ask for explicit confirmation.
20. On confirmation only, apply the patch, update last_reviewed to today, set review_by from the dominant confidence level, regenerate llms-full.txt, and run npm run validate.