CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

commit

Analyze git diffs or staged changes and generate conventional commit messages that explain WHY a change was made. Supports auto-detecting type and scope, intelligent file staging, and interactive overrides. Use when asked to "write a commit message", "generate a commit", "describe my changes", "commit this", "summarize my diff", or "/commit".

Quality

88%

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.

The body delivers concrete, executable, well-sequenced guidance for all four modes with real git commands and precise formatting rules. Its main defect is bundle integrity: every section defers to references/conventional-commits.md, which does not exist, leaving the promised detail unreachable; a smaller gap is the missing validate-after-generate feedback loop.

Suggestions

Create the missing references/conventional-commits.md with the sections the body cites (Type Classification, Scope Rules, Message Structure, Body and Footer Rules, Atomic Commits, Validation Rules), or inline the essential rules and drop the reference lines.

Add a feedback loop to generate mode: after producing the message, run validate mode against it and fix any violations before presenting the final output.

Trim known-concept explanations — the imperative-mood walkthrough and the per-type glosses — to just the allowed type list and a single style example.

DimensionReasoningScore

Conciseness

Largely efficient — it assumes git knowledge and gives terse numbered steps with inline commands rather than prose. Minor over-explanation could be trimmed: the imperative-mood walkthrough ("'add', 'fix', 'remove' — not 'added', 'fixes'") and the one-line glosses on standard conventional-commit types restate concepts Claude already knows, though the type list doubles as the allowed-list referenced by validate mode. Not 5 because of those trimmable passages; not 3 because padding is minor and localized.

4 / 5

Actionability

Fully executable guidance: exact commands (`git diff --staged`, `git diff HEAD`, `git status`, `git add <files>`, `git diff --staged --stat`, `git log -1 --format=%B`), a concrete subject-line template `<type>(<scope>): <imperative verb> <what and why>` with hard 72-char limits, a good-vs-bad example, and the full message structure in a copy-paste-ready block. Per the rubric's code-vs-instruction note, an instruction-only skill with this level of specific guidance earns the top anchor.

5 / 5

Workflow Clarity

Each mode has a clear numbered sequence with some explicit checkpoints — analyze's conditional fallback ("if empty, run `git diff HEAD`"), stage's confirmation via `git diff --staged --stat` and its ask-which-group prompt, and validate's PASS/violations report with corrected lines. Not 5 because generate mode ends at output without a feedback loop (e.g., "run validate mode on the generated message"), a minor validation gap that fits anchor 4.

4 / 5

Progressive Disclosure

The body is well-structured into four mode sections, each ending with a clearly signaled one-level-deep reference line ("Reference: `references/conventional-commits.md` → Type Classification, Scope Rules"), but scoring against the actual bundle shows no `references/` directory exists — all four references point to a missing file, so the deferred detail (Validation Rules, Scope Rules, Atomic Commits) is inaccessible. Not 4 because the disclosure structure is only partially realized; not 2 because signaling and in-body organization are good and content is not wrongly inlined.

3 / 5

Total

16

/

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 strong description: concrete capabilities, third-person voice, explicit trigger clause with natural user phrasings, and a clearly distinct niche. The only improvement would be mentioning the validate mode for full coverage of the skill's advertised functionality.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Analyze git diffs or staged changes and generate conventional commit messages that explain WHY", "auto-detecting type and scope", "intelligent file staging", "interactive overrides" — but the validate mode (checking existing messages against the spec) is never mentioned, a minor coverage gap that keeps it below the comprehensive anchor 5.

4 / 5

Completeness

Explicitly answers both questions: the "what" is "Analyze git diffs or staged changes and generate conventional commit messages that explain WHY a change was made" and the "when" is the explicit clause "Use when asked to..." with concrete quoted trigger phrases — a direct match for the anchor 5 example. Not 4, because the "when" is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Six natural trigger phrases users would actually say — "write a commit message", "generate a commit", "describe my changes", "commit this", "summarize my diff", and the slash command "/commit" — comprehensively covering synonyms and invocation styles for this domain. It does not fit anchor 4 since no obvious natural variant is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche — conventional commit message generation from git diffs — with triggers dominated by unmistakably commit-specific phrases ("commit this", "/commit", "generate a commit"); conflict risk is minimal. The secondary phrases "describe my changes"/"summarize my diff" have only slight overlap with diff-summary skills, which still fits "minimal conflict risk" better than anchor 4's "minor overlap risk".

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

14

/

16

Passed

Repository

nitinjain999/platform-skills

Path

skills/commit/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.