CtrlK
BlogDocsLog inGet started
Tessl Logo

commit

Read this skill before making git commits

55

Quality

61%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/commit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a concise, well-structured Conventional Commits guide: executable commands, a precise format spec, and a clear numbered workflow with a clarification checkpoint. It respects Claude's competence and adds only what is needed.

DimensionReasoningScore

Conciseness

The body is lean and efficient — it gives the format spec, terse notes, and a short numbered workflow without explaining git or commit concepts Claude already knows, so every token earns its place.

3 / 3

Actionability

It provides concrete, executable commands (`git status`, `git diff`, `git log -n 50 --pretty=format:%s`, `git commit -m "<subject>"`) plus a precise format specification, making the guidance copy-paste ready.

3 / 3

Workflow Clarity

The numbered Steps give a clear sequence with an explicit clarification checkpoint ('If there are ambiguous extra files, ask the user for clarification before committing'); this is not a destructive/batch operation requiring a validate-fix-retry loop, so no cap applies.

3 / 3

Progressive Disclosure

This is a single-purpose skill under 50 lines with no external references, and the content is organized into clearly labeled sections (Format, Notes, Steps); per the simple-skills scoring note this can score 3 without external file references.

3 / 3

Total

12

/

12

Passed

Description

22%

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 minimal and procedural rather than capability-oriented: it tells Claude to read the skill before committing without naming what the skill does or giving explicit trigger guidance. It is distinguishable as git-commit-related but lacks completeness and specificity.

Suggestions

Rewrite the description to state concrete capabilities first, e.g., 'Create a git commit with a concise Conventional Commits-style subject for the current changes.'

Add an explicit trigger clause such as 'Use when the user asks to commit changes, write a commit message, or stage and commit files.'

Include natural keyword variations ('commit', 'commit message', 'stage changes') to improve trigger coverage.

DimensionReasoningScore

Specificity

The description 'Read this skill before making git commits' names no concrete capabilities — it is a meta-instruction to read the skill rather than a statement of what the skill does, matching the 'vague or no actions' anchor.

1 / 3

Completeness

It fails to answer 'what does this do' (saying 'read this skill' instead of describing actions), and there is no explicit 'Use when...' clause; per the guideline a missing trigger clause caps completeness at 2, and the 'what' is effectively absent.

1 / 3

Trigger Term Quality

'making git commits' is a natural phrase a user might say, but coverage is thin with no variations (e.g., 'commit', 'commit message', 'stage changes'), so it only partially matches the natural-keyword anchor.

2 / 3

Distinctiveness Conflict Risk

'making git commits' is somewhat specific to a version-control niche but the description is generic enough to overlap with other git/version skills, so it sits at the 'somewhat specific but could overlap' anchor.

2 / 3

Total

6

/

12

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
mitsuhiko/agent-stuff
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.