CtrlK
BlogDocsLog inGet started
Tessl Logo

tlc-spec-driven

Feature planning and implementation with 4 adaptive phases (Specify, Design, Tasks, Execute). Auto-sizes depth by complexity. Writes testable requirements in EARS notation, atomic tasks, atomic Conventional Commits, and requirement traceability. Ships deterministic Python validation scripts so structural gates are enforced by code, not memory. Features an independent Verifier (author != verifier, evidence-or-zero), a discrimination sensor, a decision log (STATE.md), a test-coverage matrix, and a self-improving lessons layer. Stack-agnostic and tool-agnostic. Use when (1) planning features, (2) implementing with verification and atomic commits, (3) validating an implementation against a spec. Triggers on "specify feature", "discuss feature", "design", "tasks", "implement", "validate", "verify work", "UAT", "record decision", "pause work", "resume work". Do NOT use for pure architecture decomposition analysis or standalone technical design documents.

75

Quality

92%

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

88%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 overview with real validation gates and genuine error-recovery loops; every referenced file exists and navigation is systematic. Its weaknesses are modest: rule duplication across sections and an over-detailed Sub-Agent Delegation section that duplicates its own reference file.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely non-obvious procedural content (no explanations of concepts Claude already knows), but there is noticeable redundancy: the atomic-commit and always-on-Verifier rules each appear in both 'Critical Rules' and 'Sub-Agent Delegation', the sub-agent offer is stated twice (Before Execute and the Sub-Agent trigger), and the script list appears in both the gates section and '.specs Structure'. This fits 'efficient; minor instances of over-explanation that could be trimmed' better than anchor 3, since nothing is wasted on background explanation.

4 / 5

Actionability

Concrete, copy-pasteable commands throughout: 'python3 <skill-dir>/scripts/validate_spec.py <spec-path-or-feature>', 'check_commit.py --message "<msg>"', plus exact artifact paths, an auto-sizing decision table, and a numeric batch budget (~7 tasks, > ~8 tasks triggers sub-agents). Guidance is fully executable without reading anything else for the core loop.

5 / 5

Workflow Clarity

The Specify → Design → Tasks → Execute pipeline is sequenced with an auto-sizing matrix, per-gate validation scripts, an explicit feedback loop ('A non-zero exit means STOP and fix before proceeding'), a safety valve for wrongly skipped phases, a bounded fix→re-verify loop (3 iterations), and blast-radius limits on destructive operations. This matches the anchor-5 pattern of clear sequence, explicit validation, and error-recovery loops.

5 / 5

Progressive Disclosure

All 12 references linked in the body exist in references/ and are signaled one level deep via inline links plus two trigger-pattern→file tables, and the 5 scripts are real and consistently addressed via <skill-dir>. Slightly below the top anchor because the 'Sub-Agent Delegation' section inlines substantial mechanics (batch packing rules, Verifier's 5 steps) that are also the stated content of sub-agents.md — a minor organization gap where the overview carries reference-level detail.

4 / 5

Total

18

/

20

Passed

Description

96%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 dense, highly explicit description that clearly states capabilities, an enumerated use-when clause, trigger phrases, and a do-not-use boundary. The only real risk is that several one-word triggers are generic enough to overlap with other development-workflow skills.

DimensionReasoningScore

Specificity

Lists multiple concrete, verifiable capabilities: 'Writes testable requirements in EARS notation, atomic tasks, atomic Conventional Commits, and requirement traceability', 'Ships deterministic Python validation scripts', 'independent Verifier (author != verifier, evidence-or-zero), a discrimination sensor, a decision log (STATE.md)'. Coverage of the skill's actions is comprehensive, matching the anchor-5 example's breadth.

5 / 5

Completeness

Explicitly answers both questions: what ('Feature planning and implementation with 4 adaptive phases... deterministic Python validation scripts...') and when ('Use when (1) planning features, (2) implementing with verification and atomic commits, (3) validating an implementation against a spec'), plus a negative scope clause ('Do NOT use for pure architecture decomposition analysis'). This mirrors the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Trigger phrases are natural user utterances with good synonym coverage: 'specify feature', 'discuss feature', 'implement', 'validate', 'verify work', 'UAT', 'record decision', 'pause work', 'resume work'. Both lifecycle verbs and colloquial variants are present, satisfying the comprehensive-coverage anchor.

5 / 5

Distinctiveness Conflict Risk

The spec-driven niche and the explicit 'Do NOT use for...' exclusion make it mostly distinct, but the single-word triggers 'design', 'tasks', 'implement', and 'validate' are generic and could fire for unrelated requests, giving minor overlap risk with general coding-workflow skills. Not 5 because those bare-word triggers are broader than the clear-niche anchor; not 3 because the negative-scope clause and domain framing substantially disambiguate it.

4 / 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
tech-leads-club/agent-skills
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.