CtrlK
BlogDocsLog inGet started
Tessl Logo

conventional-commits

Generates and formats git commit messages following the Conventional Commits specification. Use when the user asks for help writing commit messages, formatting git commits, wants to write a commit msg for staged changes, needs to produce a changelog entry, or mentions conventional commits, semantic versioning, or version bumps. Analyzes diffs or change descriptions, selects the correct type/scope, writes an imperative-mood header under 72 characters, and composes optional body and footer sections including breaking-change notation.

72

Quality

89%

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

78%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 strong, highly actionable body with concrete decision rules, copy-paste examples, and an explicit pre-commit validation step, supported by a clean two-file reference structure that follows progressive disclosure well. The main weakness is token efficiency: it re-explains spec knowledge Claude already has (type table, SemVer mapping in Mindset) and duplicates rules and an example across sections.

Suggestions

Trim the Mindset section and Type Reference table — Claude already knows the standard Conventional Commits types and their SemVer mapping; keep only the decision rules for ambiguous cases (refactor vs feat, chore as last resort) which are the genuinely non-obvious guidance.

Remove the duplication: the `feat(auth): add OAuth2 login support` example appears both in the agent output format and in Examples, and the header rules (imperative, lowercase, ≤72 chars) are stated in Procedure steps 4–6 and repeated under 'Rules' — state each once.

Add a short feedback loop to Procedure step 7 (e.g., 'if commitlint reports a violation, fix the header/body and re-run before committing') to upgrade the validation checkpoint into a recovery path.

DimensionReasoningScore

Conciseness

Mostly efficient but includes unnecessary explanation and duplication: the Mindset section restates the Conventional Commits/SemVer contract ("`feat` triggers a MINOR version bump, `fix` triggers PATCH") and the Type Reference table re-lists standard spec types Claude already knows; the `feat(auth): add OAuth2 login support` example appears twice (Procedure output format and Examples), and the 72-char/imperative rules are stated in Procedure steps 4–6 and again under Rules. Not level 4: the redundancy (duplicated example, repeated rules, known-spec table) is more than minor trimming; not level 2: the bulk is genuinely useful judgment content with no padding prose.

3 / 5

Actionability

Fully executable guidance: a format template, copy-paste-ready example messages covering feature/fix/breaking/perf cases, concrete decision rules for ambiguities ("does the user gain new capability? If yes → `feat`"), and runnable commands (`echo "feat(auth): add OAuth2 login support" | npx commitlint`, `git log --format="%s" HEAD~5..`). Not level 4: common cases are covered with copy-paste-ready output plus a ready-to-paste agent output format.

5 / 5

Workflow Clarity

The Procedure is a clearly sequenced 7 steps with an explicit verification checkpoint ("run `git commit --dry-run` or your local commitlint hook"), and the 'If applied, this commit will' check is a concrete validation heuristic. Not level 5: there is no feedback loop for error recovery (what to do when validation fails) and no checklist; the validation step exists but recovery handling is implicit. Not level 3: validation is explicitly present as a numbered step, not missing.

4 / 5

Progressive Disclosure

Clear overview with well-signaled, one-level-deep references that exist in the bundle (references/scope-and-strategy.md, references/tooling.md); deeper material (scope vocabulary, commitlint/semantic-release setup) is appropriately split out, inline links are descriptive, and the References section annotates each file plus external spec links. Not level 4: navigation is clean, both referenced paths resolve to real files, and nothing that belongs in a reference is inlined.

5 / 5

Total

17

/

20

Passed

Description

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

The description is exemplary: third-person voice, concrete capabilities with a measurable constraint, and an explicit 'Use when' clause covering natural user phrasings and synonyms. Both the 'what' and 'when' are answered clearly, and the trigger vocabulary is tightly scoped to the conventional-commits niche.

DimensionReasoningScore

Specificity

Quotes: "Analyzes diffs or change descriptions, selects the correct type/scope, writes an imperative-mood header under 72 characters, and composes optional body and footer sections including breaking-change notation" — multiple concrete, specific actions with a measurable constraint (72 chars), comprehensively covering the skill's capabilities. Not level 4: there are no minor gaps; header, body, footer, and breaking-change notation are all enumerated.

5 / 5

Completeness

Explicitly answers both: what ("Generates and formats git commit messages following the Conventional Commits specification") and when ("Use when the user asks for help writing commit messages... or mentions conventional commits, semantic versioning, or version bumps") with concrete trigger phrases. Not level 4: the 'when' clause is already explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Quotes: "help writing commit messages", "formatting git commits", "commit msg for staged changes", "changelog entry", "conventional commits, semantic versioning, or version bumps" — comprehensive natural-phrase coverage including synonyms ("commit msg", "changelog entry") and spec terminology. Not level 4: no commonly used trigger phrase for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Conventional Commits message generation) with distinct triggers like "conventional commits, semantic versioning, or version bumps" that would not naturally fire for unrelated skills. Not level 4: the trigger set is tightly scoped to this skill's domain; only a hypothetical near-duplicate commit-formatting skill could overlap.

5 / 5

Total

20

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
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.