CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

commit-conventions

Use when the user asks for a commit message or wants help summarizing staged changes, e.g. "write a commit" or "git commit message". Reads the staged diff, picks the Conventional Commits type (feat, fix, refactor, docs, test, perf, chore), and writes an imperative subject of at most 72 characters, adding a body only for breaking changes, migrations or security fixes.

75

Quality

94%

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

The canonical home for this skill is commit-conventions in chandler767/WorkJournal

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 tight, well-structured instruction-only skill: a concrete command, an explicit output format, a complete type-decision table, and clear edge-case and safety guidance, with zero padding. Its single gap is the absence of a worked input/output example commit message to anchor the subject-line rules.

Suggestions

Add one short worked example under 'Subject line rules' showing a staged change and the resulting message, e.g. Input: token-refresh fix in api/ → Output: "fix(api): drop expired token from cache key", to reach fully copy-paste-ready guidance.

Optionally mirror one full message example including a body case (breaking change) so the conditional body rule in step 4 is demonstrated, not just described.

DimensionReasoningScore

Conciseness

Lean and efficient: no explanation of what git, commits, or Conventional Commits are — it only supplies what Claude would not already know (the type table with decision criteria like "Empty files and stubs don't count", the 72-char rule, scope guidance). Every section and line earns its place; nothing is padded. Not 4: there are no instances of over-explanation to trim.

5 / 5

Actionability

Concrete and executable: exact command "git diff --cached", explicit format template "<type>(<optional scope>): <subject>", measurable rules (imperative mood, lowercase, no trailing period, 72 chars), and a full decision table. Not 5: there is no worked example of an input change and its resulting commit message (e.g., "fix(api): drop trailing slash on redirect"), which the format rules would otherwise leave unshown; not 3: the guidance is fully concrete and directly executable, with only that minor gap.

4 / 5

Workflow Clarity

The 5-step numbered sequence is unambiguous, includes decision guidance for the ambiguous case ("If changes are mixed, pick the type that covers all of them, not the largest file"), and an explicit safety boundary ("Do not commit, just suggest it to the user"). The operation is non-destructive (suggestion-only), so the validation-cap guideline does not apply; no feedback loop is needed since nothing is modified. Not 4: there are no gaps — edge cases and the stopping point are both explicit.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (none exist in the bundle), and per the rubric's simple-skill guideline it qualifies for 5 with well-organized sections. Sections ("When you're triggered", "What to do", "Type table", "Subject line rules") are clear, appropriately sized, and nothing that belongs in a separate file is inlined. Not 4: structure and placement are fully appropriate at this scale.

5 / 5

Total

19

/

20

Passed

Description

92%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: third-person, concrete, and comprehensive, with an explicit 'Use when' clause carrying quoted natural trigger phrases. The only soft spot is trigger-term breadth — a couple of common user phrasings are not covered.

Suggestions

Add one or two more natural trigger variants, e.g. "or 'draft a commit message' / 'summarize my staged changes'", to broaden trigger coverage toward the 5 anchor.

DimensionReasoningScore

Specificity

"Reads the staged diff, picks the Conventional Commits type (feat, fix, refactor, docs, test, perf, chore), and writes an imperative subject of at most 72 characters, adding a body only for breaking changes, migrations or security fixes" — multiple specific concrete actions covering the full workflow (read diff, classify type, write subject, conditional body) with a measurable constraint (72 chars). Verbs are third person ('Reads', 'picks', 'writes'), so no voice penalty applies. Not 4: coverage is comprehensive with no gaps; every step of the task is named explicitly.

5 / 5

Completeness

Explicitly answers both: what — "Reads the staged diff, picks the Conventional Commits type... writes an imperative subject of at most 72 characters, adding a body only for breaking changes, migrations or security fixes"; and when — "Use when the user asks for a commit message or wants help summarizing staged changes, e.g. 'write a commit' or 'git commit message'" with concrete quoted trigger phrases. Matches the 5 anchor exactly.

5 / 5

Trigger Term Quality

Includes natural phrases users would say: "asks for a commit message", "summarizing staged changes", with quoted examples "write a commit" and "git commit message". Not 5: a few common variations are missing (e.g., "draft a commit message", "help me commit", "summarize my diff/changes"); not 3: quoted example triggers plus the two main phrasing families give good, not just 'some relevant', keyword coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Conventional Commits message generation from staged diffs) with distinct triggers that would not fire for unrelated skills; it is closely comparable to a listed good_overall_example ("Generate descriptive commit messages by analyzing git diffs. Use when the user asks for help writing commit messages..."). Minimal conflict risk.

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

chandler767/WorkJournal

Path

.tessl/plugins/chandler-playground/git-hygiene/skills/commit-conventions/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.