Use when creating git commits to ensure commit messages follow project standards. Applies the 7 rules for great commit messages with focus on conciseness and imperative mood.
67
80%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.agents/skills/git-commit/SKILL.mdQuality
Discovery
75%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 functional with a clear 'Use when' clause and a well-defined niche around git commit message formatting. Its main weaknesses are moderate specificity (could enumerate more concrete actions like analyzing diffs or formatting subject/body) and limited trigger term coverage (missing common user phrasings). Overall it's a solid mid-range description that would work well in most skill libraries.
Suggestions
Add more specific concrete actions, e.g., 'Generates commit messages by analyzing staged changes, formats subject lines in imperative mood, wraps body text at 72 characters'
Expand trigger terms to include variations users might say: 'commit msg', 'staged changes', 'git message', 'conventional commits'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (git commits) and some actions (creating commit messages, applying 7 rules, imperative mood, conciseness), but doesn't list multiple concrete specific actions like 'analyze diffs', 'format subject lines', 'wrap body at 72 chars'. | 2 / 3 |
Completeness | Clearly answers both 'what' (applies 7 rules for great commit messages with focus on conciseness and imperative mood) and 'when' (explicitly starts with 'Use when creating git commits to ensure commit messages follow project standards'). | 3 / 3 |
Trigger Term Quality | Includes 'git commits' and 'commit messages' which are natural terms users would say, but misses common variations like 'commit msg', 'staged changes', 'git message', 'conventional commits', or 'git log'. | 2 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to git commit message formatting with specific methodology (7 rules, imperative mood), making it unlikely to conflict with other skills like general git operations or code review skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, actionable skill for git commit message formatting. It provides clear rules, concrete examples (both good and bad), an executable commit format, and a validation checklist. Minor verbosity in the explanatory sections (particularly the 'Key Principles' and 'Problem:' annotations on bad examples) prevents a perfect conciseness score, but overall the skill is effective and practical.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes some unnecessary content. The 'Bad Examples' section with detailed explanations of why they're bad adds bulk, and some principles (like 'Be concise, not verbose') are things Claude already understands. The good/bad example pairs are valuable but the 'Problem:' explanations could be trimmed. | 2 / 3 |
Actionability | Provides concrete, copy-paste ready examples of both good and bad commit messages, an executable HEREDOC format for proper commit formatting, specific character limits, and a clear checklist. The guidance is specific and directly usable. | 3 / 3 |
Workflow Clarity | For a single-task skill (writing commit messages), the workflow is unambiguous: follow the 7 rules, use the HEREDOC format, check against the checklist. The checklist serves as an explicit validation checkpoint before committing, which is appropriate for this scope. | 3 / 3 |
Progressive Disclosure | For a self-contained skill under 80 lines with no need for external references, the content is well-organized with clear sections (rules, principles, format, examples, checklist) that progress logically from rules to application to verification. | 3 / 3 |
Total | 11 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
3b58a22
Table of Contents
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.