CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

commit

Writes brief conventional-commit messages, runs pre-commit checks, stages changes, commits them, and proposes splitting when the diff mixes concerns. Use when the user asks to commit, stage and commit, write a commit message, or split a change into atomic commits.

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

82%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 lean, actionable reference for a single-purpose skill: concrete rules, executable workflow, and well-chosen good/bad examples. The main gaps are the soft, conditional validation step and minor redundancy between the body's opening, Usage section, and frontmatter.

Suggestions

Give the pre-commit validation a fallback when `make checks` is unavailable (e.g., run the project's test/lint command or proceed with a warning) so the workflow's checkpoint is unconditional — this would lift workflow_clarity.

Trim the opening paragraph and Usage section, which restate the frontmatter description and argument-hint, and condense the Types list to only non-obvious mappings (e.g., fold `style`, `perf`, `ci` into one line) to tighten conciseness.

Add a short post-commit verification step (e.g., confirm with `git log -1 --stat`) so the workflow ends with an explicit success checkpoint.

DimensionReasoningScore

Conciseness

The body is tight and operational — terse message rules, compact examples, no explanation of git or conventional-commit concepts beyond a 9-line type table. It sits at the score-4 anchor (efficient, minor trimming possible): the Types list largely restates knowledge Claude already has, the opening paragraph repeats the frontmatter description, and the verbose counterexample block is slightly long for the point it makes.

4 / 5

Actionability

Guidance is concrete and executable: a message template, hard rules ("under 60 characters", "no trailing period", "cap it at two short sentences or three bullets"), specific commands ("run `make checks`", "inspect staged files and `git diff`"), and good/with-body/bad examples that cover the common cases. This matches the score-5 anchor for an instruction-only skill with fully actionable, example-backed guidance.

5 / 5

Workflow Clarity

The three-step workflow is clearly sequenced, the pre-commit check acts as an explicit validation step, and the Notes section defines the failure path ("ask whether to fix or proceed") — matching the score-4 anchor's 'clear sequence with most checkpoints'. It falls short of score 5 because validation is conditional ("if available") with no fallback, and there is no post-commit verification (e.g., confirming the commit landed via `git log`).

4 / 5

Progressive Disclosure

The body is well-sectioned (Workflow, Message Rules, Types, Splitting Criteria, Examples, Options, Notes) and nothing that belongs in a separate file is inlined, matching the score-4 anchor (good structure, content appropriately placed, minor gaps). The skill exceeds the 50-line threshold where well-organized sections alone warrant a 5, and there is minor redundancy between the opening paragraph, the Usage section, and the frontmatter.

4 / 5

Total

17

/

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 that explicitly answers both what the skill does and when to use it, using third person and natural trigger phrases. The only room for improvement is slightly broader trigger coverage (e.g., "make a commit", "amend").

DimensionReasoningScore

Specificity

The description lists five concrete actions — "Writes brief conventional-commit messages, runs pre-commit checks, stages changes, commits them, and proposes splitting when the diff mixes concerns" — giving comprehensive coverage of the skill's capabilities with no generic filler. This matches the score-5 anchor (multiple specific concrete actions, comprehensive) and exceeds the score-4 anchor, which would imply minor coverage gaps.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is the full action list, and the "when" is a concrete "Use when the user asks to commit, stage and commit, write a commit message, or split a change into atomic commits" clause with concrete trigger phrases. This is a direct match for the score-5 anchor and clearly above score 4, where the "when" would be less specific.

5 / 5

Trigger Term Quality

Trigger phrases are natural — "asks to commit, stage and commit, write a commit message, or split a change into atomic commits" — covering the main phrasings a user would actually say. It falls just short of the score-5 anchor because common variations like "make a commit", "commit my changes", or "amend a commit" are missing, but it clearly exceeds the score-3 anchor (missing common variations).

4 / 5

Distinctiveness Conflict Risk

The niche is clear — git commit authoring with conventional-commit formatting, pre-checks, and atomic-split proposals — and every trigger phrase is specific to that niche, matching the score-5 anchor (clear niche, distinct triggers, minimal conflict risk). It is more focused than the score-4 anchor's 'minor overlap risk with closely related skills' case.

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

rikdc/ai-skills

Path

plugins/git-workflow/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.