CtrlK
BlogDocsLog inGet started
Tessl Logo

contextual-commit

Write contextual commits that capture intent, decisions, and constraints alongside code changes. Use when committing code, finishing a task, or when the user asks to commit. Extends Conventional Commits with structured action lines in the commit body that preserve WHY code was written, not just WHAT changed.

68

Quality

83%

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

The canonical home for this skill is contextual-commit in berserkdisruptors/contextual-commits

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 well-crafted, instruction-only skill with an unambiguous format spec, concrete workflow, and exemplary worked examples that leave no doubt about execution. Its weaknesses are modest: a few trimmable sections and an example set that could be externalized for progressive disclosure.

Suggestions

Trim 'The Problem You Solve' to one sentence and cut or compress the 'Git Workflows' section, which mostly restates git behavior Claude already knows.

Move the four multi-line commit examples into a single one-level-deep reference file (e.g., references/examples.md), keeping one representative example inline in SKILL.md.

Add an explicit final checkpoint in 'Before You Write the Commit' — e.g., re-verify the commit scope against `git diff --cached --stat` and the Rules checklist before composing the message.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanation of git basics, and every action type is taught by example rather than prose. 'The Problem You Solve' is motivational framing and 'Git Workflows' states things Claude already knows about merges/rebases, which keeps it below anchor 5, but the padding is minor — anchor 4, not 3, since the bulk is dense and signal-bearing.

4 / 5

Actionability

Fully executable guidance: an exact line grammar ('action-type(scope): description'), a concrete command ('git diff --cached --stat'), and worked examples spanning simple, moderate, complex, and mid-pivot cases with realistic action lines. Matches anchor 5 — copy-paste-ready patterns covering the common cases; not 4 because there are no gaps in the guidance for the skill's core task.

5 / 5

Workflow Clarity

'Before You Write the Commit' gives a clearly sequenced, branching procedure (staged-vs-unstaged, has-context-vs-lacks-context) with an explicit check step, and the Rules section doubles as a checklist. Missing an explicit final validation pass (e.g., re-check the commit scope before writing) puts it at anchor 4 rather than 5. Commits are not destructive/batch operations, so the workflow-clarity cap for missing validation does not apply.

4 / 5

Progressive Disclosure

A single-file skill with no bundle files (no references/, scripts/, or assets/ exist) and no dangling or dead references — all sections are well-organized and navigable. Anchor 4 rather than 5 because the ~180-line body keeps the full action-type catalogue and four multi-line example blocks inline, some of which (the examples) could live one level deep in a separate reference file.

4 / 5

Total

17

/

20

Passed

Description

83%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 clearly and concretely states both capability and triggers, with a distinctive WHY-capture framing that differentiates it from ordinary commit-message skills. The main improvement opportunity is broader trigger synonyms ('commit message', 'git commit') to sharpen matching.

Suggestions

Add natural trigger synonyms such as 'commit message(s)' or 'git commit' to the 'Use when...' clause to improve keyword coverage.

Consider naming one or two of the action types (e.g., intent, decision, rejected) in the description to sharpen specificity and distinctiveness against generic commit-message skills.

Reconsider 'finishing a task' as a trigger — it is very broad and could cause the skill to fire on non-commit workflow completions.

DimensionReasoningScore

Specificity

Names several concrete, domain-specific actions — 'Write contextual commits that capture intent, decisions, and constraints', 'Extends Conventional Commits with structured action lines in the commit body' — with only a minor gap (the specific action types are not enumerated). It sits between anchor 3 ('1-2 concrete actions') and anchor 5 ('multiple specific concrete actions; comprehensive coverage'), noticeably above the midpoint.

4 / 5

Completeness

Explicitly answers both what ('Write contextual commits... preserve WHY code was written, not just WHAT changed') and when ('Use when committing code, finishing a task, or when the user asks to commit') with concrete trigger phrases, matching anchor 5 exactly. Not 4 because the 'when' clause is specific and multi-trigger, not merely present.

5 / 5

Trigger Term Quality

'committing code', 'finishing a task', and 'when the user asks to commit' are natural user phrasings with good coverage, but common synonyms like 'commit message(s)' and 'git commit' are absent. Good coverage with a few natural terms missing — anchor 4, not 5.

4 / 5

Distinctiveness Conflict Risk

The contextual/action-line niche is clear and distinguishable, but 'Use when committing code... when the user asks to commit' is broad enough to overlap with a generic commit-message or Conventional Commits skill. Mostly distinct with minor overlap risk against closely related skills — anchor 4, not 5 (which requires minimal conflict risk) and not 3 (the WHY-preservation framing is distinctive).

4 / 5

Total

17

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
yamadashy/repomix
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.