CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sdx-commit

Analyzes git changes, groups them by logical change or OpenSpec feature, and creates conventional commits for each group. Use when organizing staged changes, splitting commits into atomic units, or creating structured commits instead of one mixed commit.

1.02x
Quality

85%

Does it follow best practices?

Impact

94%

1.02x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is spec-driven-magic/sdx-commit

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.

A tight, executable workflow skill: concrete git commands at every step, a clear batch-commit sequence with user confirmation and post-commit verification, and a well-defined conventional-commit format. The main improvements are trimming the redundant Guidelines section, clarifying the multi-line message example, and adding an error-recovery path for failed or mismatched commits.

Suggestions

Collapse the 'Guidelines' section into 'Commit Message Format' (or trim to only non-format guidance) to remove the duplicated rules about line length, intent-summarizing, and single-logical-unit commits.

Replace the 'Multi-line' example with a genuine multi-line commit (subject + body via multiple -m flags) so the 'use multiple -m flags' instruction has a matching, unambiguous example.

Add a brief recovery step for the batch loop: what to do if 'git diff --cached --name-only' shows files outside the current group, or if a commit fails mid-sequence (e.g., unstage, re-check, retry).

DimensionReasoningScore

Conciseness

The body is mostly lean — commands, grouping rules, and message format with no padding or explanations of concepts Claude already knows. Minor redundancy trims it below a 5: the 'Guidelines' section restates 'Commit Message Format' rules ('Each line should tell the reader what changed, not how' vs 'concise description of what changed'; 'summarize by intent' vs "Don't list every file"), and 'If all changes are part of one logical unit, a single line is fine' repeats the 'one commit per change group' guidance.

4 / 5

Actionability

Nearly every step carries executable commands (git status --porcelain, git diff --name-only, git add --, git diff --cached --stat, git commit -m) plus concrete message examples like 'feat(connector): add Klaviyo connector with cursor pagination'. Falls short of 5 due to template placeholders ('git log --oneline -<N>', '<file1> <file2>') and the 'Multi-line (when spanning multiple areas)' example, which actually shows four separate commit messages rather than one multi-line message, leaving the multi-`-m` mechanics slightly underspecified.

4 / 5

Workflow Clarity

Clear numbered sequence (check changes → group → draft plan → confirm with user → stage/commit per group → verify) with real checkpoints for a batch operation: 'Review the staged summary' after staging, 'index should be clean after commit', and step 6's 'Confirm each planned group was committed'. Not a 5 because there is no error-recovery feedback loop (e.g., what to do when the staged set doesn't match the plan or a commit fails mid-run).

4 / 5

Progressive Disclosure

No bundle files exist, and the single-file layout is appropriate: well-organized sections (Steps, Commit Message Format, Guidelines) with all content one level deep and easy to navigate. Minor gaps keep it at 4: the Guidelines section's overlap with Commit Message Format rules blurs section boundaries, and the body runs ~128 lines where the grouping heuristics could stand as their own reference if the skill grows.

4 / 5

Total

16

/

20

Passed

Description

88%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: it names three concrete actions in third-person voice and pairs them with an explicit, naturally phrased 'Use when' trigger clause covering the main use cases. The only gaps are a few missing trigger synonyms (commit-message writing, reviewing diffs) and minor overlap risk with generic commit-message skills.

DimensionReasoningScore

Specificity

'Analyzes git changes, groups them by logical change or OpenSpec feature, and creates conventional commits for each group' lists three specific, concrete actions in third-person voice ('Analyzes', 'groups', 'creates') that fully cover the skill's behavior. Not below 5: there is no generic filler, and no meaningful capability of the skill is left unnamed in the description.

5 / 5

Completeness

Both halves are explicit: the 'what' is 'Analyzes git changes, groups them by logical change or OpenSpec feature, and creates conventional commits for each group', and the 'when' is the concrete 'Use when organizing staged changes, splitting commits into atomic units, or creating structured commits instead of one mixed commit' trigger clause. This matches the 5 anchor's requirement of an explicit what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Strong natural phrasing users would actually say: 'organizing staged changes', 'splitting commits into atomic units', 'structured commits instead of one mixed commit'. A few common variants are missing — e.g. 'write commit messages', 'make atomic commits', 'review the diff' — which keeps it at the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The niche (commit splitting/grouping into atomic units) and its triggers are distinct from generic skills, but there is minor overlap risk with closely related commit-message skills — e.g. a 'generate descriptive commit messages by analyzing git diffs' skill could also fire on 'organizing staged changes'. Not a 3: the splitting/structuring language clearly differentiates it from single-message generation.

4 / 5

Total

18

/

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

xomyakus/spec-native-skills

Path

tiles/sdx-commit/skills/sdx-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.