seo-action-plan
Skill6 starsChanged 3 months agoApache-2.0View on GitHub
Use when turning validated SEO, AEO, GEO, technical, or measurement findings into an approval-ready, evidence-linked action plan without claiming guaranteed ranking, citation, traffic, or conversion outcomes.
In this repository27 other files it gives its agents.
- llms.txtllms.txt
- ai-search-researchSkill
- ai-visibility-monitorSkill
- optimise-seoSkill
- seo-aeoSkill
- seo-agenticSkill
- seo-architectureSkill
- seo-auditSkill
- seo-authoritySkill
- seo-commerceSkill
- seo-competitor-pagesSkill
- seo-contentSkill
- seo-geoSkill
- seo-hreflangSkill
- seo-imagesSkill
- seo-localSkill
- seo-news-discoverSkill
- seo-pageSkill
- seo-performanceSkill
- seo-planSkill
- seo-programmaticSkill
- seo-researchSkill
- seo-schemaSkill
- seo-sitemapSkill
- seoSkill
- seo-technicalSkill
- seo-videoSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 5 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 10
Read markdown-delivery-contract.md for every task.
- Distinctive: line 23
Do not promise inclusion, ranking, citation, referral, traffic, revenue, or conversion lift.
- Very specific: line 24
Do not invent a platform requirement.
- Distinctive: line 26
Never treat a crawler request or bot log as evidence of retrieval, grounding, citation, referral, or conversion.
- Distinctive: line 27
Do not turn a speculative or experimental finding into a normal implementation action.
- Very specific: line 32
Read references/action-plan-protocol.md before creating action-plan.json.
- Very specific: line 62
Validate before handoff: Use validate-plan; fix every error.
- Distinctive: line 78
If a formal input bundle is unavailable, do not fabricate one.
- Distinctive: line 98
Do not include raw secrets, personal data, copied customer analytics, or unlicensed content in the plan bundle.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SEO Action Plan
Markdown delivery contract
Read markdown-delivery-contract.md for every task. Write a substantive .md document for every material work step and register its direct destination in the work index.md. For public-site work, apply the owner-required Markdown discovery profile across the full eligible inventory; preserve native standards and immutable evidence formats.
Lane outputs: action-plan.md; acceptance-map.md (combine small related steps with stable section links). Carry owner-required Markdown discovery as a publisher requirement with evidence-linked content/transport acceptance, not a claimed engine requirement. Bind every approved action ID to a substantive .md document, owner, exact affected routes, verification and rollback.
Purpose
Turn evidence-backed findings into a sequenced implementation plan that a content, engineering, analytics, product, or legal owner can approve and execute. This skill plans work; it does not change a site, publish content, modify crawler controls, deploy code, or approve its own recommendations.
Use it after seo-aeo or seo-geo has produced a validated optimization-brief.json, or after a conventional SEO specialist has produced a validated seo-findings.json bundle. For a normal conversational audit without a validated artifact, provide a clearly labelled provisional action list and name the evidence needed before it becomes a formal plan.
Non-negotiable boundaries
- Do not promise inclusion, ranking, citation, referral, traffic, revenue, or conversion lift.
- Do not invent a platform requirement. The owner-defined Markdown discovery profile, including
llms.txt, is an accepted publisher requirement. Special “AI schema”, fixed chunk sizes, bot access or crawler-control claims still require scoped current evidence; publisher preferences never prove engine adoption. - Separate an observed issue from its likely cause and from the proposed change.
- Never treat a crawler request or bot log as evidence of retrieval, grounding, citation, referral, or conversion.
- Do not turn a speculative or experimental finding into a normal implementation action. Keep it as a monitored experiment or decline it.
- Require human approval for production, policy, legal, accessibility, analytics, or crawler-control changes. The plan’s approval status starts as
pending.
Formal-plan workflow
Read references/action-plan-protocol.md before creating action-plan.json.
Check the input gate. Require an immutable, validated upstream bundle. An AEO/GEO input contains
optimization-brief.json,research-pack.json, and its referenced raw evidence. A conventional SEO input containsseo-findings.jsonand the raw evidence it names. Run:Let
<suite-root>mean${CLAUDE_PLUGIN_ROOT}in Claude Code. In Codex, read.seo-suite-runtime.jsonbeside thisSKILL.mdwhen present and use itssuite_rootvalue; otherwise use the absolute repository checkout, then run:python "<suite-root>/scripts/validate_seo_action_plan.py" validate-plan <plan>/action-plan.json --bundle <plan>Validate a conventional input directly before packaging it when possible:
python "<suite-root>/scripts/validate_seo_findings.py" validate-findings <findings>/seo-findings.json --bundle <findings>The runtime skill locator resolves the installed support package containing the suite-level validators and contracts; a retained repository checkout is optional.
The plan bundle must preserve each upstream bundle below
inputs/; do not edit its artifacts after validation. Use Action Plan1.2.0when it contains SEO Findings1.1.0, Optimization Brief1.1.0, or expanded action/verification types. Action Plan1.1.0remains valid for legacy SEO Findings1.0.0, and1.0.0remains valid for legacy Optimization Brief1.0.0-only plans.- Map the evidence. For every proposed action, link at least one finding and at least one resolving evidence record. Keep locale, engine, surface, target, and claim scope intact. An action may combine findings only when their scopes are compatible.
Choose a real owner and a reversible path. Assign the responsible team/role, required approver, effort, risk, dependencies, acceptance criteria, verification method, guardrail, and rollback method.
seo-action-planitself cannot be the implementation owner.Action Plan
1.2.0requiresrisk_flags. Declare every applicable policy, crawler/indexing, legal/privacy, accessibility, experiment-wide, or irreversible risk. Any declared flag is high risk and requires the matching approval and rollback; do not hide sensitive work behind a generic technical or content label.- Use confidence honestly.
highneeds confirmed evidence;mediumcannot rest on experimental evidence;lowis an explicitly monitored hypothesis. Decline changes that lack sufficient evidence, conflict with platform documentation, or would create legal/accessibility risk. - Write only executable, reviewable instructions. Say what will change, what will not change, how it will be checked, and which observable signal would justify keeping or reverting it. Use a source-specific metric: search-console visibility, analytics/referrals, manual content review, recrawl, log review, or a repeatable visibility run. Do not collapse these into a universal score.
- Validate before handoff. Use
validate-plan; fix every error. A passing file proves structural traceability, not that the recommendation will work or that the upstream evidence is current.
Routing from the plan
- Content/editorial: send approved actions to
seo-content; preserve the evidence and claim boundaries in the content brief. - Technical implementation: send approved actions to
seo-technical; include rollback and platform-specific crawler/control evidence. - Structured data: send approved actions to
seo-schema; require visible-content alignment and rich-result eligibility checks, never a rich-result promise. - International targeting: send approved actions to
seo-hreflangorseo-sitemapwhen the action’s locale or discovery scope requires it. - Commerce and local: send product/feed actions to
seo-commerceand location/profile/NAP actions toseo-local. - Media and publishing: send video actions to
seo-videoand publisher/news/Discover actions toseo-news-discover. - Agent, architecture, and authority: send task-flow/protocol actions to
seo-agentic, taxonomy/internal-link/site-graph actions toseo-architecture, and backlink/mention/source-landscape actions toseo-authority. - Measurement: send conventional search/site performance work to
seo-performanceand AI-answer observations toai-visibility-monitor; keep their metric families separate. - Prioritization and coordination: send cross-team approved work to
optimise-seoorseo-plan.
Provisional action list
If a formal input bundle is unavailable, do not fabricate one. Respond with a short table or list containing:
- observation and its source/capture;
- proposed action and owner;
- evidence gap or uncertainty;
- approval needed;
- verification and rollback;
- the exact artifact or observation needed to upgrade it to a validated formal plan.
Label all such items provisional; do not write them to action-plan.json.
Output checklist
For a formal plan, return:
action-plan.json, validated against the checked-in contract;- a readable action summary grouped by priority and owner;
- explicit declined actions and limitations;
- a statement that approval is pending and that outcomes are not guaranteed.
Do not include raw secrets, personal data, copied customer analytics, or unlicensed content in the plan bundle.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

