CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-commit

Standardized Git commit generator skill with Conventional Commits rules, scope tagging (e.g. feat(itau):, fix(security):), and change summary rules.

Quality

73%

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

Quality

Content

75%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 well-structured, actionable, and concise for a single-file skill: concrete git commands, a complete worked example, security verification steps, and a clear four-step workflow. Remaining improvements are minor — trimming standard Conventional Commits glossary content and completing the truncated example commit command.

DimensionReasoningScore

Conciseness

The body is list-driven and lean — schemas, scope tables, and a full example commit with no fluffy prose — but it re-explains standard Conventional Commits knowledge Claude already has (e.g. one-line definitions of "docs", "style", "chore", imperative-mood examples, "no trailing period"), matching the 4-anchor of minor over-explanation that could be trimmed. It is above 3 because the padding is limited to single-line glosses and the project-specific content (custom types like "sec"/"arch", FinanceHub scopes) genuinely earns its tokens.

4 / 5

Actionability

Concrete executable commands are given throughout: "git status --short", "git diff --staged", "git diff", and a ready "git commit -m ... -m ..." invocation, plus a complete worked example message. Minor gaps keep it at 4 rather than 5: the Step 4 commit command truncates the body with "..." (not copy-paste ready) and staging files is never addressed.

4 / 5

Workflow Clarity

The four-step workflow (inspect → analyze/categorize → draft → verify & execute) is a clear sequence with pre-execution checkpoints: "Scan diffs for sensitive data or unintended file inclusions" and "Verify line lengths and format". It is not 5 because there is no post-commit validation (e.g. checking the result) or feedback loop on failure; commits are not destructive/batch operations, so the cap-at-3 rule does not apply.

4 / 5

Progressive Disclosure

The skill is a single self-contained file with no bundle files (no references/, scripts/, or assets/), and content is well organized into numbered sections with clear subsections (structure rules, security rules, workflow). It sits at 4 rather than 5 because at ~100 lines the commit-type and scope lists could arguably live in a reference file, and it slightly exceeds the under-50-line simple-skill guideline that would otherwise justify a 5.

4 / 5

Total

16

/

20

Passed

Description

58%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.

The description clearly conveys what the skill does and is reasonably specific with concrete scope-tagging examples, but it lacks any explicit "Use when..." trigger guidance and misses common natural trigger phrases like "commit message". Adding an explicit trigger clause would resolve its main weaknesses.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to commit changes, write or generate commit messages, or review staged changes in FinanceHub."

Include natural trigger synonyms such as "commit message", "draft a commit", and "conventional commits" so the skill matches how users actually phrase the request.

Briefly mention the pre-commit secret/PII scanning capability to broaden and differentiate the described feature set.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "Conventional Commits rules, scope tagging (e.g. feat(itau):, fix(security):), and change summary rules" — with illustrative examples, going beyond the 3-anchor's 1-2 actions. It is not a 5 because coverage is incomplete (no mention of analyzing diffs, secret scanning, or the workflow) and "rules" phrasing describes enforcement more than actions.

4 / 5

Completeness

The "what" is clear (generates standardized commits with Conventional Commits rules and scope tagging), but there is no "Use when..." clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. Not 4+ because the "when" is entirely absent rather than merely implicit.

3 / 5

Trigger Term Quality

Relevant keywords like "Git commit generator" and "Conventional Commits" exist, but common natural phrases users would say are missing — e.g. "commit message", "write/draft a commit", "staged changes" — matching the 3-anchor ("some relevant keywords but missing common variations or synonyms"). It is above 2 because the core term "git commit" is exactly what users say; below 4 because no synonyms or trigger variants appear.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — project-specific scope examples "feat(itau):, fix(security):" and "Conventional Commits" differentiate it from generic skills. Minor overlap risk remains with any other generic commit-message or version-control skill, so it is not a 5.

4 / 5

Total

14

/

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

JoseMD12/finance-hub

Path

.agents/skills/git-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.