CtrlK
BlogDocsLog inGet started
Tessl Logo

git-commit-guidelines

Enforce git commit best practices using gitmoji + Conventional Commits format. TRIGGER when creating commits. Ensures quality-gate passes, prevents issue auto-closing (no Close/Fix keywords), includes Co-Authored-By for AI commits, and requires user approval before committing.

60

Quality

68%

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/skills/git-commit-guidelines/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 is highly actionable with an exemplary validation-gated workflow, but it is heavily padded — every core rule is repeated across five-plus sections, including a redundant ASCII quick-reference card. The single-file structure also inlines a large example library that belongs in a separate reference file.

Suggestions

Collapse the repetition: keep the 7-step workflow and format table as the single source of truth, and cut or drastically shorten the failure examples, DO/DO NOT lists, quick-reference card, and REMEMBER footer, which restate the same rules.

Trim the eight example scenarios to 2-3 representative ones (or move the full set to a references/examples.md file) to reduce token cost without losing coverage.

State each rule once at the point of use in the workflow instead of restating it in trigger, failure, table, list, card, and closing sections.

DimensionReasoningScore

Conciseness

The same five rules (run quality-gate, ask permission, never Close/Fix/Resolve, always use gitmoji, include Co-Authored-By) are restated in the trigger checklist, four failure examples, the format rules table, the 7-step workflow, eight example scenarios, the DO/DO NOT lists, the ASCII quick-reference card, and the closing REMEMBER paragraph — noticeably verbose with several padded, redundant sections. It avoids explaining concepts Claude already knows, which keeps it above the 1 anchor, but the repetition is far beyond the 'minor trimming' of the 4 anchor.

2 / 5

Actionability

Guidance is fully executable and copy-paste ready: concrete commands ('npm run quality-gate', 'git status', 'git diff --staged', 'git log -1 --pretty=format:"%h %s"'), a complete HEREDOC commit template, a fully specified message format with per-element rules, and eight worked example commit messages covering the common cases. This matches the 5 anchor exactly.

5 / 5

Workflow Clarity

The 7-step workflow is clearly sequenced with explicit validation checkpoints: quality-gate must pass with issues fixed before proceeding (Step 2, a validate-fix-retry feedback loop), staged changes are reviewed before composing the message (Step 3), and the commit is verified with 'git log -1' and 'git status' afterward (Step 7). This matches the 5 anchor's explicit validation steps and error-recovery loop; it is not a destructive/batch operation that lacks verification.

5 / 5

Progressive Disclosure

The single 366-line file has good section headers, but content that clearly belongs in a separate reference file is inlined — notably the eight-example scenario library and the gitmoji reference table, both of which are lookup material rather than workflow. With no bundle files and no external references, this sits at the 3 anchor ('content that should be separate is inline'); it is above 2 because the sections themselves are well-organized and navigable.

3 / 5

Total

15

/

20

Passed

Description

67%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, behavior-focused description that clearly states what the skill enforces and includes an explicit trigger clause. Its main weaknesses are a thin set of natural trigger terms and a trigger clause that covers only one phrasing of 'commit'.

Suggestions

Broaden the trigger clause with natural user phrasings, e.g. 'TRIGGER when the user asks to commit changes, create a commit, or before running git commit.'

Include the high-frequency noun phrase 'commit message' in the description, since users most often ask for help writing one.

State the post-commit verification behavior to close the small coverage gap between the description and the body's 7-step workflow.

DimensionReasoningScore

Specificity

The description lists several concrete enforcement actions — 'Enforce git commit best practices using gitmoji + Conventional Commits format', 'Ensures quality-gate passes', 'prevents issue auto-closing (no Close/Fix keywords)', 'includes Co-Authored-By for AI commits', 'requires user approval before committing'. It falls short of the 5 anchor because a few body-level behaviors (post-commit verification, English-language requirement, subject-line constraints) are absent from the description, leaving minor coverage gaps; it clearly exceeds the 3 anchor, which expects only 1-2 concrete actions.

4 / 5

Completeness

It answers 'what' clearly through five enumerated enforcement behaviors and answers 'when' explicitly via 'TRIGGER when creating commits'. The 'when' clause is present but narrow — it does not enumerate the concrete trigger phrases (user asks to commit, about to run git commit) that a 5 anchor requires, matching the 4 anchor ('both present; when could be more explicit or specific').

4 / 5

Trigger Term Quality

The only trigger phrasing is 'TRIGGER when creating commits' — a relevant keyword but one that misses the natural variations users actually say, such as 'commit message', 'commit this', 'commit changes', or 'git commit'. This matches the 3 anchor ('some relevant keywords but missing common variations or synonyms'); it is above 2 (which requires only generic keywords) and below 4, which expects good coverage with just a few terms missing.

3 / 5

Distinctiveness Conflict Risk

The niche is clear and narrow — commit message formatting and commit-approval policy — with distinctive markers (gitmoji, Conventional Commits, quality-gate) that separate it from generic git skills. There is minor overlap risk with broader git-workflow or PR-review skills that also touch commits, matching the 4 anchor rather than the 5 anchor's 'minimal conflict risk'.

4 / 5

Total

15

/

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
cteyton/packmind
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.