CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

blog-taxonomy

Suggest tags and categories for a blog post from its content, audit a site's tag and category health, and, only after the user approves a shown plan, sync tags and categories to WordPress, Shopify, Ghost, Strapi, or Sanity. suggest and audit are read-only; sync is dry-run by default and never deletes, merges, or edits post content. Use when the user says "tag suggestions", "taxonomy audit", "sync tags", "WordPress tags", "Shopify tags". Not for keyword research (blog-brief) or schema markup (blog-schema).

Quality

87%

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

77%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.

Operationally excellent content: concrete API guidance, exemplary consent/verification workflow with feedback loops, and disciplined, non-padded prose. The main weaknesses are structural — the five CMS adapters are inlined wholesale in SKILL.md instead of being split into reference files, and the referenced orchestration-details.md is absent from the bundle — plus one minor URL-interpolation inconsistency.

Suggestions

Move the five CMS adapter sections into per-adapter reference files (e.g. references/adapters/wordpress.md) and keep only the adapter-overview table plus one-line links in SKILL.md.

Resolve the dangling reference: either ship references/orchestration-details.md in the bundle or remove/repath the instruction to read it, since no references/ directory exists.

Fix the WordPress list-tags example to pass the search term as an encoded parameter consistent with the skill's own no-string-interpolation rule.

DimensionReasoningScore

Conciseness

The body is dense and operational — it never explains concepts Claude already knows (what tags are, what REST is) and includes genuinely non-obvious details like Ghost JWT signing and Shopify access scopes. A few tokens could be trimmed: the standalone "Manage tags and categories across CMS platforms.", the stop-word list ("articles, prepositions, conjunctions, pronouns"), and repeated "checked 2026-10-12" citations — so it sits at the 4 anchor rather than 5.

4 / 5

Actionability

Highly executable: exact endpoints, request bodies, pagination rules ("follow `X-WP-TotalPages` header", "loop while `pageInfo.hasNextPage` is true"), numeric thresholds, and status-code error handling. Falls short of fully copy-paste-ready because the WordPress list-tags example interpolates `{keyword}` into the URL query, contradicting the skill's own hard limit "never by string interpolation into a query or URL" — a minor inconsistency in otherwise concrete guidance.

4 / 5

Workflow Clarity

The 6-step consent gate has explicit validation checkpoints and feedback loops throughout: dry-run plan, approval by host and counts, "Execute only the approved items, one post first... verify it by re-reading, then continue", "Stop on the first unexpected response", and a rollback record. Batch-write validation is thoroughly present, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The file is well-sectioned (Commands table, per-workflow, per-adapter) but ~150 lines of CMS adapter API reference are inlined in SKILL.md rather than split into per-adapter reference files, and the one reference named — "Read the main reference `orchestration-details.md`" — does not exist in the bundle (no references/ directory exists), leaving it unresolvable. Good internal structure keeps this above 2, but the inlined bulk and dangling reference keep it below 4.

3 / 5

Total

16

/

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: third-person, concrete, comprehensive over all three commands and five platforms, with an explicit trigger clause and negative scope. The only weakness is trigger-term coverage, which misses a few natural synonyms and CMS-specific variants.

Suggestions

Add natural trigger variants such as "categorize posts", "blog tags", and "Ghost/Strapi/Sanity tags" to the Use-when clause.

Consider a trigger phrase for the audit workflow's user-facing vocabulary, e.g. "tag cleanup" or "unused tags", which is how users often describe taxonomy health checks.

DimensionReasoningScore

Specificity

"Suggest tags and categories for a blog post from its content, audit a site's tag and category health, and... sync tags and categories to WordPress, Shopify, Ghost, Strapi, or Sanity" lists multiple concrete actions across all five supported platforms, with write-safety bounds ("never deletes, merges, or edits post content"). Coverage of the skill's three commands is complete rather than minor-gap, matching the 5 anchor.

5 / 5

Completeness

Both what (suggest/audit/sync with read-only vs. gated write semantics) and when (quoted trigger phrases) are explicitly stated, plus negative scope ("Not for keyword research (blog-brief) or schema markup (blog-schema)"). This matches the 5 anchor's explicit what-and-when with concrete triggers; the when-clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

'Use when the user says "tag suggestions", "taxonomy audit", "sync tags", "WordPress tags", "Shopify tags"' provides natural phrases users would actually say. Falls short of the 5 anchor because common variations like "categorize posts", "blog tags", and the remaining CMS names (Ghost/Strapi/Sanity tags) are absent.

4 / 5

Distinctiveness Conflict Risk

A clear niche (blog taxonomy across five named CMS platforms) with distinct triggers, and it explicitly disambiguates from sibling skills ("Not for keyword research (blog-brief) or schema markup (blog-schema)"). Minimal conflict risk — it goes beyond reducing overlap by naming the skills to avoid.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

AgriciDaniel/claude-blog

Path

skills/blog-taxonomy/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.