CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

delivery-gate

Stop hook that blocks Claude from finishing until quality checks pass. Detects rationalization patterns (surface text heuristics), stale learning logs (filesystem mtime), and low disk space. Complements self-audit by mechanically enforcing learning capture habits. Use when Claude should be mechanically blocked from declaring work finished before quality checks and learning capture actually pass.

Quality

87%

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.

The body is a well-organized, largely executable reference for the hook: behavior is specified precisely via tables and worked examples, and blocking rules are stated deterministically. The main weaknesses are the missing script file in the bundle, the absence of a post-install verification/troubleshooting step, and a few trimmable meta sections.

Suggestions

Ship the implementation in the skill bundle (e.g. scripts/quality-gate.py) and reference it with a bundle-relative path, so the install step is executable from the skill alone.

Add a short post-install verification step (e.g. trigger a Stop and confirm the hook runs, or check hook registration) plus 2-3 troubleshooting lines for the hook not firing or Python 3.8+ missing.

Trim the CI-pipeline analogy, the 'ship and forget' narrative, and the 'Quality' section about past code-review rounds; they do not change what the agent or user does.

DimensionReasoningScore

Conciseness

The body is mostly efficient — tables for checks and configuration, compact worked examples with exit codes — but the CI-pipeline analogy, the 'ship and forget' narrative in Why, and the 'Quality' section recounting '4 rounds of automated code review... 9 real bugs found and fixed' are meta-padding that could be trimmed. This matches 'efficient with minor instances of over-explanation' rather than the lean 'every token earns its place' anchor.

4 / 5

Actionability

Install commands, the full settings.json hook config, a configuration table with defaults, and worked examples with exit codes and stderr messages are concrete and executable. However, the central artifact — 'skills/delivery-gate/hooks/quality-gate.py' — is not present in the skill bundle (no scripts/ directory), so the core install step cannot be executed from the skill alone.

4 / 5

Workflow Clarity

The install-then-configure sequence is concrete and unambiguous, and the Examples section documents outcomes (exit 0 vs exit 2 with the exact stderr text) for allowed and blocked paths. The gap is validation: there is no post-install step to verify the hook actually fires, and no troubleshooting for a silently non-firing hook or missing Python.

4 / 5

Progressive Disclosure

The document is well-structured with clear sections, a flat layout, and one-level-deep See Also links. But the single substantive file reference, 'cp skills/delivery-gate/hooks/quality-gate.py', points outside the skill and does not resolve to any file in the bundle, so navigation to the implementation is broken — a minor organization gap rather than the fully clear reference structure of the top anchor.

4 / 5

Total

16

/

20

Passed

Description

92%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.

The description is strong: it states concrete capabilities with mechanisms, an explicit 'Use when' trigger, and a clear distinction from adjacent skills, all in third-person voice. Its only weakness is incomplete synonym coverage for natural trigger phrases.

DimensionReasoningScore

Specificity

The description names multiple concrete actions with their mechanisms — 'blocks Claude from finishing until quality checks pass', 'Detects rationalization patterns (surface text heuristics)', 'stale learning logs (filesystem mtime)', and 'low disk space' — covering all three of the hook's checks comprehensively. Third-person voice throughout, so no voice penalty applies.

5 / 5

Completeness

The 'what' is explicit (a Stop hook with three named checks) and the 'when' is an explicit trigger clause: 'Use when Claude should be mechanically blocked from declaring work finished before quality checks and learning capture actually pass.' Both are answered clearly with a concrete condition, matching the top anchor rather than the 'when could be more explicit' anchor at 4.

5 / 5

Trigger Term Quality

Natural terms like 'quality checks pass', 'declaring work finished', 'learning capture', and 'low disk space' are phrases users would plausibly say, giving good coverage. It misses common synonyms and casual variations ('done', 'wrap up', 'session hygiene'), so it falls short of the comprehensive-synonym anchor at 5.

4 / 5

Distinctiveness Conflict Risk

'Complements self-audit by mechanically enforcing learning capture habits' carves out a clear niche (deterministic mtime/regex/disk checks) and explicitly distinguishes it from the reasoning-quality gate sibling. Conflict risk with other skills is minimal because the trigger is specific to mechanical blocking.

5 / 5

Total

19

/

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

affaan-m/ECC

Path

skills/delivery-gate/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.