CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-maintenance

Editing conventions for files under `.claude/skills/**` (markdown style, frontmatter format, SKILL.md vs `references/` split, upstream-vendored skills). Use when creating a new skill, editing any `SKILL.md` or `references/*.md` file, refactoring a skill description, or after adding/removing a skill.

Quality

85%

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

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

A well-structured, genuinely actionable conventions skill with clear decision rules, checklists, and a validation philosophy. Its main costs are redundancy: the description-length ceiling is repeated across three sections, and the Canonical guidelines section restates upstream best practices that add tokens without adding repo-local value.

Suggestions

Consolidate the 1024-char ceiling guidance into a single section: it is currently explained in Token economy, When to refactor a description, and Canonical guidelines, with overlapping restatements of the do-not-trim-preemptively rule.

Replace the Canonical guidelines section's restatement of upstream best practices with a brief link plus only the repo-specific deltas, since Claude and the linked document already know the canonical content.

Provide a concrete command for measuring the folded description length (e.g., a short YAML round-trip one-liner) so the 'measure, do not eyeball' rule is directly executable.

DimensionReasoningScore

Conciseness

Mostly efficient, rule-dense prose that assumes competence, but it includes avoidable repetition: the 1024-char ceiling is stated three times (Token economy, When to refactor a description, Canonical guidelines), and the Canonical guidelines section restates upstream Anthropic best practices (hard limits, progressive-disclosure tiers) that the linked document and Claude's own knowledge already cover. This matches the 'mostly efficient but could be tightened' anchor rather than the minor-trim anchor at 4.

3 / 5

Actionability

Concrete, executable guidance throughout: wrap at 100 characters, ASCII only, only `name` and `description` keys, use the `>-` folded scalar with a copy-paste YAML example, an annotated WHAT/WHEN example, and a validation procedure ('prompt a Coding Agent... with a trigger phrase'). It stops short of 5 because 'measure it before saving' the folded description length never provides an actual command or method to do the measurement.

4 / 5

Workflow Clarity

The edit workflow is clearly sequenced with checkpoints: apply conventions on every edit, the After-Editing checklist explicitly requires deciding add/remove/tighten triggers and 'State explicitly that no change is needed... Do not skip the check silently', and the Validating section defines a post-change verification step. Minor gap: the validation step is described abstractly (no concrete prompt example or pass/fail criteria) rather than as an explicit feedback loop, so it sits at 4 rather than 5.

4 / 5

Progressive Disclosure

A single well-sectioned SKILL.md (~180 lines, well under its own 500-line guidance) with no bundle files and no nested references, which is appropriate for always-apply conventions. It is not a 5 because the Canonical guidelines section duplicates upstream documentation that could be reduced to a short pointer, the one minor organization gap in an otherwise clean structure.

4 / 5

Total

15

/

20

Passed

Description

95%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 well-formed WHAT+WHEN description in third person with concrete, naturally phrased triggers and file-path keywords covering the full skill-editing lifecycle. The only weakness is that the description does not reflect every convention the body enforces (commit scope, validation procedure), leaving a minor coverage gap.

DimensionReasoningScore

Specificity

The WHAT names the domain ('Editing conventions for files under `.claude/skills/**`') and enumerates four concrete facets ('markdown style, frontmatter format, SKILL.md vs `references/` split, upstream-vendored skills'), which sits between anchor 4 and 5. It is not a 5 because the body also covers commit-scope conventions and change-validation procedures that the description omits, a minor coverage gap.

4 / 5

Completeness

Both parts are explicit: a clear WHAT ('Editing conventions for files under `.claude/skills/**` (markdown style, frontmatter format, ...)') followed by an explicit 'Use when...' clause with four concrete trigger phrases, exactly matching the top anchor. The third-person voice is consistent throughout.

5 / 5

Trigger Term Quality

The WHEN clause comprehensively covers the natural verbs of the skill lifecycle ('creating a new skill', 'editing any `SKILL.md` or `references/*.md` file', 'refactoring a skill description', 'after adding/removing a skill') plus concrete file paths (`.claude/skills/**`, `SKILL.md`, `references/*.md`), matching the comprehensive-synonyms-and-extensions anchor.

5 / 5

Distinctiveness Conflict Risk

The niche is tightly scoped to maintaining skills under `.claude/skills/**` in this repo, including vendored-skill handling, with distinct file-path triggers. It would not plausibly fire for unrelated markdown or documentation tasks, so conflict risk is minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

SRombauts/SQLiteCpp

Path

.claude/skills/skill-maintenance/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.