CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

work-unit-commits

Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.

Quality

81%

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

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 strong instruction-only skill body: lean, concrete, and well-structured, with actionable rules and a checklist that doubles as a validation gate. The main trimmable part is the Commands section of basic git commands, and the only structural gap is the absence of an explicit feedback loop.

DimensionReasoningScore

Conciseness

The body is dense and functional — rules table, checklist, and split examples with no padding and no explanation of concepts Claude already knows. The Commands section ('git diff --stat', 'git log --oneline -5') shows basic git commands Claude already knows, so not every token earns its place.

4 / 5

Actionability

Concrete, executable guidance throughout: a rules table, before/after commit-message examples ('feat(auth): add token validation domain model and tests'), a pre-commit checklist, and runnable git commands. Minor gaps — e.g., it requires recording a 'Focused test command and exact result' but shows no example of that record's format.

4 / 5

Workflow Clarity

The PR Relationship section gives a numbered 4-step sequence (build smallest unit → include verification → commit → promote to chained PRs) and the Work Unit Checklist acts as an explicit pre-commit checkpoint. Not a 5 because there is no explicit validate → fix → retry feedback loop; committing is not a destructive/batch operation so the score-3 cap does not apply.

4 / 5

Progressive Disclosure

Well-organized sections with clear headers, single-file structure, and no content that clearly belongs in a separate bundle file. It exceeds the under-50-lines simple-skill case that would merit a 5, and the dense ODD Relationship section is the one candidate for extraction, so it sits at 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

78%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 well-formed description with explicit what-and-when structure and natural trigger phrases; the explicit 'Trigger:' clause makes it a textbook completeness case. Its only weakness is that the capability statement is a single action rather than a fuller list of specific capabilities.

Suggestions

List the concrete capabilities in the description itself, e.g., 'Plan commits as reviewable work units: split features into self-contained commits, keep tests and docs with the behavior they cover, and promote commits into chained PRs.'

Add common trigger synonyms such as 'stacked PRs', 'split commits', or 'reviewable diffs' to the Trigger clause to capture more natural user phrasings.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — 'Plan commits as reviewable work units' — but does not list several specific capabilities. It matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor; a 4 would require several listed actions and a 2 would mean generic or minimal actions.

3 / 5

Completeness

It explicitly answers both what ('Plan commits as reviewable work units') and when, via an explicit 'Trigger:' clause with concrete trigger phrases — matching the top anchor verbatim in structure. A 4 would require the 'when' to be less explicit than it is here.

5 / 5

Trigger Term Quality

'Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code' gives good natural-phrase coverage. Not a 5 because common synonyms users might say are missing (e.g., 'stacked PRs', 'split up commits', 'reviewable diffs').

4 / 5

Distinctiveness Conflict Risk

A clear niche (work-unit commit planning) with distinct triggers like 'commit splitting' and 'chained PRs'. Minor overlap risk remains with adjacent commit-message-writing and general PR-preparation skills, keeping it below the minimal-conflict anchor 5.

4 / 5

Total

16

/

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

Gentleman-Programming/gentle-ai

Path

internal/assets/skills/work-unit-commits/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.