CtrlK
BlogDocsLog inGet started
Tessl Logo

documentation

Use when writing blog posts or documentation markdown files - provides writing style guide (active voice, present tense), content structure patterns, and SEO optimization. Overrides brevity rules for proper grammar.

71

Quality

87%

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

92%

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

The body is concise, highly actionable, and well-structured for a documentation style skill, with a clear final-pass checklist. The main weakness is progressive disclosure: broken reference paths and an unreferenced bundle file undermine otherwise strong navigation.

Suggestions

Fix the reference paths to point at the actual bundle location, e.g. './references/writing-style.md' instead of '../documentation/references/writing-style.md'.

Either reference config-json.md from the body (e.g. add a 'Configuring frontmatter' context line) or remove it from the bundle to avoid a dangling file.

DimensionReasoningScore

Conciseness

The body is lean: mostly compact tables (naming, modal verbs, component patterns) and short bullet lists, with no padded explanations of concepts Claude already knows; every section earns its place.

3 / 3

Actionability

Concrete, copy-paste-ready guidance throughout — kebab-case examples, real example sentences in the writing-patterns table, specific component syntax ('> [!NOTE]', '::: code-group'), and a checklist with measurable criteria ('Active voice (85%+)', '2-3 sentences per paragraph').

3 / 3

Workflow Clarity

As a style/reference skill with no destructive or batch operations, the closing checklist provides a clear sequenced final pass (style → structure → frontmatter validation → humanizer), which is unambiguous for a single-purpose skill.

3 / 3

Progressive Disclosure

Structure and signaling are good — a references table with purpose plus a 'Load based on context' mapping, one level deep — but the reference paths are malformed ('../documentation/references/...' rather than './references/...') and one bundle file (config-json.md) is never referenced, hurting navigation.

2 / 3

Total

11

/

12

Passed

Description

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 answers both what and when with natural trigger terms and an explicit 'Use when' clause. It is slightly let down by passive capability phrasing and a broad domain that could overlap with other writing skills.

Suggestions

Replace passive phrasing like 'provides writing style guide' with concrete verbs, e.g. 'Apply active-voice, present-tense style; structure content with component patterns; optimize for SEO'.

Tighten the niche to reduce overlap, e.g. scope to documentation/blog files that need grammar-preserving, SEO-optimized prose rather than general writing.

DimensionReasoningScore

Specificity

Names the documentation domain and three concrete deliverables ('writing style guide (active voice, present tense), content structure patterns, and SEO optimization'), but describes them as passive 'provides ... guide/patterns/optimization' rather than crisp verbs, falling short of multiple specific concrete actions.

2 / 3

Completeness

Explicitly answers both 'what' (provides style guide, content patterns, SEO optimization) and 'when' ('Use when writing blog posts or documentation markdown files') with an explicit trigger clause.

3 / 3

Trigger Term Quality

Opens with 'Use when writing blog posts or documentation markdown files', giving good coverage of natural terms a user would actually say when requesting documentation work.

3 / 3

Distinctiveness Conflict Risk

The 'blog posts or documentation' domain is fairly broad and could overlap with general writing skills, though the SEO/style/patterns focus and 'Overrides brevity rules' note add some distinctiveness.

2 / 3

Total

10

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 8 suspicious

Warning

Total

15

/

16

Passed

Repository
kubb-labs/kubb
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.