CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

finish-work

Pre-commit quality checklist covering lint, typecheck, tests, code-spec sync, API changes, database migrations, cross-layer verification, and manual testing. Blocks commit if infra or cross-layer specs lack executable depth. Use when code is written and tested but not yet committed, before submitting changes, or as a final review before git commit.

Quality

85%

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 well-built, largely executable pre-commit checklist with concrete commands, explicit conditional sections, and a genuine blocking gate for spec depth. The recurring weakness is missing feedback loops and executable forms for the softer checks (failed commands, console.log search, manual testing), plus a little motivational padding.

Suggestions

Add recovery steps to the Quick Check Flow for failed checks (e.g., 'if lint/type-check/test fails: fix the reported issues and re-run until clean') to create explicit feedback loops (workflow_clarity).

Provide the executable form of each fuzzy check — e.g., a grep command for console.log and non-null assertions, and how to verify spec sections are 'executable not principle-only' (actionability).

Trim the closing 'Core Principle' section and the 'Key Question' blockquote, which restate the checklist's intent without adding actionable guidance (conciseness).

DimensionReasoningScore

Conciseness

The body is dominated by token-efficient checklists, commands, and a consequences table with no explanation of concepts Claude already knows. Minor trimmable padding exists — the closing 'Core Principle' section ('Complete work = Code + Docs + Tests + Verification') and the 'Key Question' blockquote are motivational rather than actionable — so it sits at 'efficient with minor instances that could be trimmed' rather than the lean 5 anchor.

4 / 5

Actionability

Mostly executable guidance: concrete commands ('pnpm lint', 'pnpm type-check', 'pnpm test', 'git diff --name-only') and specific paths ('.trellis/spec/backend/', 'db/migrations/'). It is not a 5 because some checks lack their executable form (e.g., 'No console.log statements' has no search command) and 'Run $update-spec manually first' defers to another skill without detail; it is well above the 3 anchor's pseudocode/incomplete level.

4 / 5

Workflow Clarity

The 'Quick Check Flow' gives a clear sequence (code checks → view changes → check relevant items) and the Block Rule is an explicit validation gate with recovery ('do NOT finish. Run $update-spec manually first'), with must-pass commands as checkpoints. Minor gaps keep it at 4: no recovery steps when lint/type-check/tests fail, and the manual-testing items lack verification steps. This is a review checklist, not a destructive/batch operation, so no cap applies.

4 / 5

Progressive Disclosure

The skill is a single self-contained file with clear section headers and no bundle files, so nothing is buried or nested. Good structure with minor gaps — the awkward '2.5' section numbering between 2 and 3, and the 'Common Oversights'/'Relationship to Other Commands' sections could be tightened. The under-50-lines exception for a 5 does not apply to this ~145-line body, so it fits the 4 anchor rather than 5, and is clearly above the 3 anchor's disorganized/buried-reference level.

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: third-person voice, comprehensive and specific about what the checklist covers, with an explicit multi-condition 'Use when' clause and a distinctive pre-commit blocking behavior. The only weakness is modest trigger synonym coverage (e.g., no 'pull request' or 'PR' phrasing).

DimensionReasoningScore

Specificity

The description enumerates eight concrete coverage areas — 'lint, typecheck, tests, code-spec sync, API changes, database migrations, cross-layer verification, and manual testing' — plus a specific blocking behavior ('Blocks commit if infra or cross-layer specs lack executable depth'), matching the anchor for multiple specific concrete actions with comprehensive coverage. It is not a 4 because there are no minor gaps: every major pre-commit concern area is named explicitly.

5 / 5

Completeness

Both questions are answered explicitly: what ('Pre-commit quality checklist covering lint, typecheck, tests, code-spec sync, API changes, database migrations, cross-layer verification, and manual testing') and when (three concrete trigger conditions in the 'Use when' clause). This matches the top anchor; it is not a 4 because the 'when' is explicit and specific rather than merely present or vague.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: 'Use when code is written and tested but not yet committed, before submitting changes, or as a final review before git commit', plus 'Pre-commit quality checklist' — terms users would naturally say. It falls short of the 5 anchor because common synonyms such as 'pull request', 'PR', 'ship', or 'ready to merge' are absent, leaving a few natural terms missing.

4 / 5

Distinctiveness Conflict Risk

The 'Pre-commit' positioning and scope (docs sync, migrations, manual testing, spec depth) form a clear niche distinct from generic review skills, but 'as a final review before git commit' creates minor overlap risk with code-review/diff-review skills. It is mostly distinct with minor overlap, fitting the 4 anchor rather than the minimal-conflict 5 or the broader-overlap 3.

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

202780181/lingxiData

Path

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