CtrlK
BlogDocsLog inGet started
Tessl Logo

doc-maintenance

Audit README, SPEC, and PRODUCT docs against recent git history for drift and make minimal PR-ready edits. Use when asked to review docs for accuracy, after major feature merges, or on a schedule.

68

Quality

83%

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%

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

The body is a tight, well-structured instruction skill: an explicit sequenced workflow with a cross-check checkpoint, concrete edit rules, and a drift-detection checklist, all without padding. It assumes Claude's competence and every section carries actionable guidance.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — it never explains what docs or release notes are, and every section (Style baseline, Drift detection, Release-note rules) earns its place with actionable rules.

3 / 3

Actionability

Concrete guidance throughout: enumerated targets (README, CLI reference, API reference, configuration reference), precise edit rules ('Edit only the lines that need to change'), and a worked release-note example with a before/after comparison.

3 / 3

Workflow Clarity

'The pass' is an explicitly sequenced 8-step process with a verification checkpoint in step 8 ('Cross-check. Search the docs for the old behavior wording') and a Drift detection checklist, satisfying validation for batch doc edits.

3 / 3

Progressive Disclosure

A single well-organized file (~60 lines) with clearly labeled sections (When to use, When not to use, The pass, Style baseline, Drift detection, Release-note rules, Anti-patterns) and no external references needed.

3 / 3

Total

12

/

12

Passed

Description

67%

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 is specific and well-scoped to a clear niche, using proper third-person imperative voice. Its main weakness is the lack of an explicit 'Use when...' trigger clause, leaving the activation conditions implied rather than stated.

Suggestions

Add an explicit trigger clause, e.g. 'Use when a release is being cut, docs lag behind merged behavior changes, or a user-reported bug traces to outdated docs.'

Broaden trigger vocabulary to include natural user phrasings like 'documentation', 'changelog', and 'update the docs'.

State the 'when' separately from the 'what' so the activation context is unambiguous.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'detect drift, update affected pages, and add release-relevant notes' — matching the anchor for naming several specific actions.

3 / 3

Completeness

The 'what' is explicit but the 'when' is only implied via 'recent code and feature changes'; there is no 'Use when...' clause, which caps completeness at 2 per the rubric guideline.

2 / 3

Trigger Term Quality

Relevant terms ('docs', 'drift', 'release-relevant notes') appear but common user variations like 'documentation', 'changelog', or 'update the docs' are missing, so coverage is partial rather than comprehensive.

2 / 3

Distinctiveness Conflict Risk

The doc-maintenance/drift-detection niche is specific and unlikely to trigger for unrelated skills; it is clearly distinguishable.

3 / 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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
paperclipai/paperclip
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.