CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

serp-analysis

Use when the user asks to "analyze the SERP" or "SERP分析"; maps SERP features, layout, ranking factors, search intent, AI Overviews, and snippet opportunities for a query. Not for keyword demand discovery — use keyword-research. SERP分析/搜索结果

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered instruction skill: the body stays an operational overview while templates, taxonomy, and a worked example live in clearly signaled reference files, and the workflow carries explicit evidence-labeling, freshness, and completeness gates. The 8-step sequence plus exact difficulty weights and keyless connector commands make it directly executable. Only conciseness dips slightly below the top due to duplicated labeling mandates and one over-dense contract sentence.

DimensionReasoningScore

Conciseness

Operational throughout with no explanations of concepts Claude already knows, but a few spots could be trimmed: the evidence-labeling mandate is stated twice ("Label every metric Measured, User-provided..." plus the "Quality bar" paragraph) and the "Done when" clause packs six hyphen-bound qualifiers into one sentence. Not 5 because of these redundancies; not 3 because there is no real padding or filler.

4 / 5

Actionability

Provides copy-paste-ready commands with flags and caveats ("python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecrawl.py\" search \"<keyword>\" --limit 10" with --scrape/--country/--tbs, and the tavily --answer corroboration path), an exact weighted difficulty formula (Top-10 authority 25%, page authority 20%, content quality 20%, backlinks 20%, SERP stability 15%), and a concrete outlier threshold (">=2x the channel average"). Not 4: the common cases are covered end-to-end with executable commands, output templates, and a worked example reference.

5 / 5

Workflow Clarity

Eight clearly sequenced steps (bind query → map composition → analyze pages → patterns → features → intent → difficulty → recommendations) with explicit validation and feedback loops: missing inputs become "Unknown with its gap reason and prevents a partial True Difficulty score", stale observations become "NEEDS_REFRESH, not current evidence", and a "Done when" checklist plus "Quality bar" gate completion. Not 4: checkpoints are explicit and global, with error-recovery paths rather than implicit validation.

5 / 5

Progressive Disclosure

The body is a genuine overview that delegates bulk detail to three real, verified, one-level-deep bundle files (references/analysis-templates.md, references/example-report.md, references/serp-feature-taxonomy.md), each clearly signaled inline ("See [Analysis Templates](references/analysis-templates.md) for the compact templates") and again with annotations in the Reference Materials list. Not 4: content is appropriately split, navigation is easy, and no reference file chains to another.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capability list, explicit third-person 'Use when...' trigger with quoted phrases in both English and Chinese, and an explicit exclusion that routes keyword-demand work to a sibling skill. The only weakness is incomplete English synonym coverage (e.g., no 'search results page' or 'featured snippet' phrasing). All dimensions score at or near the top of the scale.

DimensionReasoningScore

Specificity

Names concrete, comprehensive capabilities — "maps SERP features, layout, ranking factors, search intent, AI Overviews, and snippet opportunities for a query" — with no gaps in domain coverage. Not 4: the enumerated scope covers the whole domain, matching the comprehensive-coverage anchor rather than 'minor gaps'.

5 / 5

Completeness

Explicitly answers both what ("maps SERP features, layout, ranking factors, search intent, AI Overviews, and snippet opportunities for a query") and when ("Use when the user asks to 'analyze the SERP' or 'SERP分析'") with concrete trigger phrases. Not 4: the 'when' is as explicit as the 'what', with a quoted trigger rather than a vague clause.

5 / 5

Trigger Term Quality

Includes a natural quoted trigger ("analyze the SERP"), the Chinese equivalents "SERP分析/搜索结果", and domain nouns like "AI Overviews" and "snippet opportunities", but misses common English variations such as "search results page" or "featured snippets". Not 5 because synonym coverage is incomplete; not 3 because the trigger phrase is exactly what a user would say.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear SERP-analysis niche and actively disambiguates from the nearest neighbor: "Not for keyword demand discovery — use keyword-research". Not 4: the explicit negative boundary plus domain-specific triggers leave minimal overlap risk.

5 / 5

Total

19

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 11 suspicious

Warning

referenced_paths_exist

Referenced path issues: 2 missing, 2 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

seo-geo/survey/serp-analysis/SKILL.md

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.