seo-audit-orchestration
Master orchestrator for a full SEO audit suite powered by the Ahrefs MCP. Use this skill when running a comprehensive SEO audit, scoping a quarterly health check, doing pre-acquisition SEO due diligence, or post-migration verification. Triggers on full SEO audit, comprehensive SEO review, SEO health check, audit my site, SEO due diligence, audit suite, comprehensive audit, end-to-end SEO. Also triggers when a stakeholder wants the complete picture rather than a single-dimension audit.
60
69%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/seo-audit-orchestration/SKILL.mdQuality
Discovery
82%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description excels at trigger term coverage and completeness, clearly stating when to use the skill with explicit trigger phrases. However, it lacks specificity about what concrete actions the skill actually performs—it describes itself as a 'master orchestrator' without listing the specific audit steps or outputs. The distinctiveness is moderate; it attempts to differentiate from single-dimension audits but could be more precise about boundaries.
Suggestions
Replace the vague 'master orchestrator' framing with specific concrete actions the skill performs, e.g., 'Runs backlink analysis, technical crawl checks, keyword gap analysis, and on-page SEO scoring using the Ahrefs MCP'.
Clarify the boundary with related single-dimension audit skills more explicitly, e.g., 'Use this skill instead of individual audit skills when the user needs a combined report across all SEO dimensions'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (SEO audit) and mentions use cases like 'quarterly health check', 'pre-acquisition due diligence', and 'post-migration verification', but it does not list concrete actions the skill performs (e.g., crawl site, check backlinks, analyze keyword rankings). 'Master orchestrator for a full SEO audit suite' is more of a role claim than a specific capability list. | 2 / 3 |
Completeness | The description clearly answers both 'what' (orchestrates a full SEO audit suite powered by Ahrefs MCP) and 'when' (explicit 'Use this skill when...' clause with multiple trigger scenarios, plus a 'Triggers on' list). Both dimensions are explicitly addressed. | 3 / 3 |
Trigger Term Quality | The description includes a strong set of natural trigger terms users would actually say: 'full SEO audit', 'SEO health check', 'audit my site', 'SEO due diligence', 'comprehensive SEO review', 'end-to-end SEO'. These cover a good range of natural language variations. | 3 / 3 |
Distinctiveness Conflict Risk | While it distinguishes itself as the 'master orchestrator' for comprehensive audits vs. 'single-dimension' audits, the phrase 'Also triggers when a stakeholder wants the complete picture rather than a single-dimension audit' is vague and could overlap with other SEO-related skills. The boundary between this and individual SEO audit skills could be clearer. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-organized orchestration skill that clearly defines scope, phases, and delegation to child skills. Its main weaknesses are redundancy between the phase descriptions and the workflow summary, lack of executable/concrete tool invocations for the Ahrefs MCP, and missing validation checkpoints between phases. The progressive disclosure is strong, appropriately delegating detail to child skills and reference files.
Suggestions
Add explicit validation checkpoints between phases (e.g., 'Verify all data pulls returned non-empty results and note freshness before proceeding to sub-audits').
Include at least one concrete MCP tool call example (e.g., the exact Ahrefs MCP function call for pulling organic keywords) to make the data gather phase actionable rather than descriptive.
Consolidate the Phase 1-6 descriptions and the Workflow section—they largely duplicate each other. Keep the detailed phases and reduce the workflow to a quick-reference checklist, or vice versa.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some redundancy—the 6 phases are described in detail and then re-summarized in the Workflow section, and sections like 'When to use' / 'When NOT to use' could be tighter. Some content (e.g., explaining what an impact/effort matrix is) assumes less intelligence than necessary. However, it avoids egregious padding and most content is relevant. | 2 / 3 |
Actionability | The skill provides a clear framework and references child skills by name, but lacks executable commands or concrete code examples. The data gathering steps mention Ahrefs tools conceptually but don't show specific MCP tool calls, API invocations, or exact commands. The guidance is structured and specific enough to follow but not copy-paste ready. | 2 / 3 |
Workflow Clarity | The 10-step workflow is clearly sequenced and logically ordered. However, there are no explicit validation checkpoints or feedback loops—no step says 'verify data completeness before proceeding' or 'if synthesis reveals data gaps, return to Phase 2.' For an orchestration skill involving multiple sub-audits and data pulls, the absence of verification gates is a notable gap. | 2 / 3 |
Progressive Disclosure | The skill effectively acts as an orchestrator, delegating detailed work to named child skills (seo-site-health-audit, seo-backlink-audit, etc.) and referencing a rollup template in references/. The structure is a clear overview with one-level-deep references. Content is appropriately split between this orchestration layer and the child skills. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- rampstackco/claude-skills
- Commit
8e70d03
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.