CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

commit

Use when the user asks to commit the current changes — groups the diff into atomic conventional commits and updates the docs each change affects. Not for reviewing a diff, and not when the user asks for a review before the commit.

64

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

67%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-structured, highly actionable workflow document with clear sequencing, validation checkpoints, and a closing checklist. Its main weakness is token efficiency: duplicated rename guidance, incident-log notes, and narrative rationales inflate the body, and some dense reference material (doc mapping, task lifecycle) is inlined rather than split out.

Suggestions

State the rename/"grep the OLD name across every resolved document" rule once (e.g., as a row in the mapping table) instead of twice — the near-verbatim repetition in the mapping list and the sync step is the single largest conciseness win.

Remove the incident-log parenthetical ("2026-09-02 and 2026-09-06: commit-doc-sync-gate synced all three documents...") — it is historical test commentary, not executable guidance, and time-sensitive content penalizes the score unless placed in a deprecated/old-patterns section.

Move the default documentation-mapping table and the FR-DOC-TASK-LIFECYCLE status-derivation spec into a references/ file (e.g. references/doc-sync.md), keeping SKILL.md as a lean overview with clearly signaled one-level-deep pointers; add a full commit-message template (type(scope): subject + body + footer) to close the actionability gap.

DimensionReasoningScore

Conciseness

The body is dense policy rather than concept explanations (no "git is..." padding), but it is noticeably redundant and over-narrated in places: the rename/"grep the OLD name" guidance appears nearly verbatim twice (in the mapping list and again in the sync step), the incident-log parenthetical ("2026-09-02 and 2026-09-06: commit-doc-sync-gate synced all three documents...") is execution-irrelevant, and several rules carry narrative rationale ("...the user is asked to sort out a mess this workflow made"). Mostly efficient but could be tightened; not so padded as to drop to 2, since nearly every sentence encodes a real rule or exception.

3 / 5

Actionability

Concrete, executable guidance throughout: a single copy-paste git state command (`git status -s && echo '---DIFF---' && ...`), `GIT_PAGER=cat`, an explicit DoD-counting status algorithm (K=0→"to do", 0<K<N→"in progress", K=N→"done"), and example messages (`agent: update commit skill with atomic grouping rules`, `build: update dependencies`). Minor gaps: no full commit-command example with message body/footer template, and "Compression Rules" are named but not specified.

4 / 5

Workflow Clarity

A clearly sequenced 6-step process with explicit checkpoints: staging verification (step 4.2), clean-state verification (step 6), and a closing Verification checklist; error handling is defined (investigate, propose fix, STOP). It falls short of the 5 anchor because the error path is stop-and-report rather than a validate→fix→retry feedback loop, and step 4.2 deliberately forbids re-reading the diff, leaving staging verification as a file-list check only.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything lives in one well-sectioned file (Overview, Context, Rules, Instructions, Verification) with no buried or nested references. Good structure, but the long default documentation-mapping rules and the task-status lifecycle spec are inline candidates for a reference file that would keep the core workflow scannable.

4 / 5

Total

15

/

20

Passed

Description

87%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: third-person voice, concrete actions, an explicit "Use when" trigger, and negative triggers that clearly separate it from review skills. Trigger-term coverage is good but could add common phrasings like "git commit" or "make a commit".

DimensionReasoningScore

Specificity

"groups the diff into atomic conventional commits" and "updates the docs each change affects" are precise concrete actions, and the exclusions ("Not for reviewing a diff", "not when the user asks for a review before the commit") sharpen scope. Two clearly stated actions plus boundaries sits between the 1-2-actions anchor (3) and several-actions-with-minor-gaps (4); the explicit boundary language pushes it above the midpoint.

4 / 5

Completeness

It explicitly answers both: what ("groups the diff into atomic conventional commits and updates the docs each change affects") and when ("Use when the user asks to commit the current changes"), and additionally supplies negative triggers. This matches the anchor for a clear what AND when with concrete trigger phrases.

5 / 5

Trigger Term Quality

"commit the current changes" is exactly what a user would naturally say, and "reviewing a diff" / "review before the commit" capture the neighboring intents that must NOT trigger it. Missing natural variations such as "git commit", "make a commit", or "check in", so not comprehensive (5).

4 / 5

Distinctiveness Conflict Risk

"Not for reviewing a diff, and not when the user asks for a review before the commit" explicitly fences off the closest competing skill (code review). The niche (commit preparation with atomic grouping and doc sync) is distinct, matching the minimal-conflict-risk anchor.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

korchasa/flowai-plugins

Path

plugins/flowai/skills/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.