CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

blog-cluster

Semantic topic cluster planning and automated execution engine for claude-blog. Performs SERP-based keyword research, groups keywords by search intent and SERP overlap, builds a hub-and-spoke cluster architecture, generates an interactive SVG cluster map, and executes the full cluster by orchestrating blog-write calls with shared cluster context and automatic internal-link injection. Fills the strategy-to-execution gap: blog-strategy plans the blueprint, blog-cluster builds the house. Use when user says "blog cluster", "topic cluster", "content cluster", "cluster plan", "cluster execute", "cluster map".

Quality

86%

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

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

The body is an exceptionally actionable orchestration spec with strong validation gates and feedback loops for a batch operation, weakened mainly by padding (a dated provenance blockquote and a table duplicating an earlier cross-reference table) and one broken reference pointer. Fixing the dangling orchestration-details.md reference and trimming the duplicate table would lift both conciseness and progressive disclosure.

Suggestions

Delete the provenance blockquote ('Adapted from the semantic-cluster-engine submission by Lutfiya Miller (winner, AI Marketing Hub Pro Challenge, March 2026, 95/100 Exemplary). Original repository: no longer available as of 2026-10-12...') — it is time-sensitive attribution metadata with no operational value for executing the skill.

Fix or remove the instruction 'Read the main reference orchestration-details.md before loading project context' — no such file exists in references/, so the lowest-hanging progressive-disclosure fix is either adding the file or deleting the pointer (lowest-scoring structure dimension: the dangling reference).

Merge the 'Cross-references to existing claude-blog skills' and 'Differentiation from related claude-blog skills' tables into one, since both describe the same sibling skills and when to use them — this directly trims the conciseness dimension's lowest-scoring duplication.

DimensionReasoningScore

Conciseness

The body is mostly efficient, skill-specific instruction (SERP overlap thresholds, link-matrix rules, failure handling), but includes unnecessary material: the provenance blockquote ('Adapted from the semantic-cluster-engine submission by Lutfiya Miller (winner, AI Marketing Hub Pro Challenge, March 2026, 95/100 Exemplary)... Original repository: no longer available as of 2026-10-12') is time-sensitive meta-information outside any 'old patterns' section, and the 'Differentiation from related claude-blog skills' table substantially duplicates the earlier 'Cross-references' table. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not score 4 since the padding is more than minor, nor score 2 since most content earns its place.

3 / 5

Actionability

Guidance is highly executable for an instruction-only skill: exact numeric thresholds ('4 or more shared top-10 results', '2,500 to 4,000' words, 'greater than 70% keyword overlap'), a complete copy-paste-ready cluster-plan.json schema, verbatim error strings, a concrete escaping spec for the XSS-safe map ('replace & with &...'), path-hardening rules, and an exact environment invocation ('env -u GOOGLE_AI_API_KEY'). Deferred details (context-block schema, cohesion formula) are explicitly pointed to in reference files, matching 'fully executable; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Both phases are clearly sequenced (Plan Steps 1-6, Strategy Import 1-6, Execute Steps 1-8) with explicit validation checkpoints and feedback loops appropriate to a batch operation: JSON validation with parse-error reporting, path canonicalization before reads, a one-time paid-execution confirmation gate ('wait for an explicit yes'), 'Wait for explicit user approval. Do not auto-execute', stop-the-batch failure handling with resume detection, and a re-review/re-render loop for link patches capped at 3 iterations. Quality-gate and error-handling tables act as checklists, matching the top anchor.

5 / 5

Progressive Disclosure

Structure is good: a 'Key references (load on demand)' section signals three one-level-deep reference files, all of which exist in the bundle and match their described purposes. However, the opening paragraph instructs 'Read the main reference orchestration-details.md before loading project context', and that file does not exist in references/ — a dangling navigation pointer — plus a cross-bundle reference to ../blog/references/flow-alignment.md; the inline ~40-line JSON schema could also live in cluster-architecture.md. This fits 'good structure; most content appropriately placed; references mostly clear; minor organization gaps' rather than the 5 anchor's clean, fully resolvable navigation.

4 / 5

Total

17

/

20

Passed

Description

88%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, action-dense, with an explicit 'Use when' trigger clause and explicit differentiation from the nearest sibling skill. The only weaknesses are a few missing natural trigger synonyms and minor overlap risk with blog-strategy on the 'cluster plan' trigger.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full pipeline: 'Performs SERP-based keyword research, groups keywords by search intent and SERP overlap, builds a hub-and-spoke cluster architecture, generates an interactive SVG cluster map, and executes the full cluster by orchestrating blog-write calls with shared cluster context and automatic internal-link injection.' This matches the anchor for multiple specific concrete actions with comprehensive coverage; score 4 would require minor gaps in coverage, but plan-through-execution is fully spanned.

5 / 5

Completeness

Both 'what' and 'when' are explicit: the 'what' is the concrete action list above, and the 'when' is a literal 'Use when user says' clause enumerating trigger phrases. This matches the top anchor (clearly and explicitly answers both what AND when with concrete trigger phrases); score 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

Trigger phrases are natural command-style terms: "blog cluster", "topic cluster", "content cluster", "cluster plan", "cluster execute", "cluster map" — good coverage including synonyms (topic/content cluster). A few plausible natural terms are missing (e.g., "keyword cluster", "pillar page", "hub and spoke"), which places it between the 'good coverage with a few missing' (4) and 'comprehensive coverage' (5) anchors; it does not clearly dominate the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche and explicitly differentiates ('Fills the strategy-to-execution gap: blog-strategy plans the blueprint, blog-cluster builds the house'), and its triggers are distinct. However, triggers like 'cluster plan' overlap the closely related blog-strategy skill (which also produces cluster plans), so risk is minor rather than minimal — matching 'mostly distinct; minor overlap risk with closely related skills' rather than the 5 anchor.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

AgriciDaniel/claude-blog

Path

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