CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

feature-blog

Ship user-facing PocketHost features with a blog post instead of semver release notes. Use when landing feat/enh work, finishing a customer-visible change, or when the user asks to announce a feature. Pair with blog-voice for writing style.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a model instruction-only skill body: lean, decision-first (ship/skip table), and fully concrete down to paths, field names, commit formats, and worked title/slug examples. The workflow is sequenced with a decision gate and an agent checklist, and all detail is appropriately delegated one level deep (blog-voice, cursor rules, real example posts).

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no concept explanations, no padding — every section is decision support or execution detail ('One feature → one post', the ship/skip table, exact paths, commit formats). Legacy version-specific references ('pockethost-2-3-0-release', 'PocketHost 3.1.0') are correctly quarantined in the 'What we stopped doing' / 'Legacy pattern to avoid' sections, so time-sensitive info costs nothing.

5 / 5

Actionability

For an instruction-only skill the guidance is fully executable: exact file paths ('packages/dashboard/src/routes/(static)/blog/{slug}/+page.md', toc.ts with its 'description, date, author' fields and top placement), concrete commit formats ('feat(…): …', 'docs(dashboard): blog post for …'), title/slug examples with anti-examples ('Direct PocketBase Version Sync', not 'PocketHost 3.1.0'), and a good-vs-legacy example pair. Nothing is pseudocode or hand-wavy; the level-4 anchor's 'minor gaps' do not apply.

5 / 5

Workflow Clarity

A clear 4-step sequence (land feature → draft post → wire the blog with sub-steps → commit) plus an explicit gating checkpoint ('Does this change matter to PocketHost end users? If no → skip post') and an end-of-work agent checklist, including the safety rule 'Ask the user before committing unless they already asked to commit'. This is not a destructive/batch operation, so no validation cap applies, and the checklist matches the level-5 anchor's 'checklists for complex processes' pattern.

5 / 5

Progressive Disclosure

The single SKILL.md is a well-organized overview with clearly signaled, one-level-deep references — style to [blog-voice](../blog-voice/SKILL.md), wiring details to '.cursor/rules/blog-articles.mdc', examples to two real blog posts, decision criteria to end-user-docs.mdc. No bundle files exist to inline, no content here belongs in a separate reference, and navigation between sections is easy, matching the top anchor.

5 / 5

Total

20

/

20

Passed

Description

82%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: explicit what and when with concrete, natural trigger phrases, a well-defined niche, and correct pairing guidance. The only soft spot is action breadth — it states its single composite action rather than enumerating the several actions the body actually covers (draft, wire, commit conventions).

DimensionReasoningScore

Specificity

The description names its domain precisely ('user-facing PocketHost features', 'blog post instead of semver release notes') and gives 1-2 concrete actions — ship each feature with its own blog post, and 'Pair with blog-voice for writing style'. It does not list several actions, so it matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor rather than the level-4 'several specific actions' anchor; it is far too concrete to fall to level 2's generic actions.

3 / 5

Completeness

Both questions are answered explicitly and concretely: what — 'Ship user-facing PocketHost features with a blog post instead of semver release notes'; when — three concrete trigger clauses ('landing feat/enh work', 'finishing a customer-visible change', 'user asks to announce a feature'). This mirrors the top anchor's structure; the level-4 anchor ('when could be more explicit') does not apply since the when-clause is fully explicit.

5 / 5

Trigger Term Quality

Natural user phrasings are present: 'Use when landing feat/enh work, finishing a customer-visible change, or when the user asks to announce a feature', plus 'blog post' and 'semver release notes'. Coverage is good but misses common variations like 'release notes', 'changelog', or 'write/ship a post', so it sits at 'good keyword coverage; a few natural terms missing' rather than the level-5 comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — per-feature blog posts for PocketHost, explicitly contrasted with semver release notes and explicitly complementary to blog-voice ('Pair with blog-voice for writing style'). Triggers are product-specific and unlikely to fire a wrong skill; the only adjacency (blog-voice) is declared as a pairing, not an overlap, so this is a clear level-5 fit rather than level 4's 'minor overlap risk'.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 4 suspicious

Warning

Total

15

/

16

Passed

Repository

pockethost/pockethost

Path

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