CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tlc-spec-driven

Feature planning and implementation with 4 adaptive phases (Specify, Design, Tasks, Execute). Auto-sizes depth by complexity. Asks every product decision before the spec is approved, writes testable requirements in EARS notation, atomic tasks with a gate and a commit each, and one check per criterion with the test that proves it. Captures that come with the request bind, and each screen is judged against them. Ships deterministic Python scripts so the gates are enforced by code, not memory; the proofs run once at the end, and an independent Verifier (author != verifier) spends its time on mutations and judgement. 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.

Quality

95%

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

92%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-engineered orchestration body: concrete gate commands, explicit validation checkpoints with stop-and-fix loops, and a clean one-level reference structure fully backed by real bundle files. Its only real cost is density and some restated rules that could be trimmed for token efficiency.

Suggestions

State the two approval stops once (Critical Rules) and have the gate table and Before Execute section reference that rule instead of restating it, cutting ~4 lines.

Move the batch-packing budget detail out of the Before Execute paragraph and keep it solely in Sub-Agent Delegation, leaving a one-line pointer behind.

Replace a few of the longest compound sentences (e.g., Critical Rule 4 and the screens sub-agent paragraph) with short imperative bullets; the rules are the same length but stop requiring re-parsing.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — "Never invent an API, a pattern or a behaviour" — with no basic-concept explanations, matching the efficient anchor. It falls short of lean because of minor redundancy that could be trimmed: approvals are restated in three places (Critical Rule 1, the gate table's "--execute" row, and the Before Execute section), and the sub-agent batching budget is explained twice (Before Execute and Sub-Agent Delegation).

4 / 5

Actionability

Guidance is fully executable: a gate table gives copy-paste-ready commands per moment ("check_commit.py --message \"<msg>\"", "check_proofs.py <feature> [--mutations <mutations.json>]") with the path convention pinned earlier ("python3 <skill-dir>/scripts/<name>.py"), plus an exact .specs file tree and exact output formats like "**Approved**: <date> - user: \"<their words>\"". Placeholders are parameterized deliberately, and the rule "Skip a script only when no code-execution tool is available; then perform the same checks by reading the artifact" covers the fallback case.

5 / 5

Workflow Clarity

The multi-step process is clearly sequenced (Specify → Design → Tasks → Execute with an auto-sizing matrix) and validation is explicit with feedback loops: "A non-zero exit means STOP and fix", a safety valve ("If that listing reveals >5 steps or complex dependencies, STOP and create a formal tasks.md"), and resume conflict rules ("continue when the files and git agree; stop only on a conflict"). Checkpoints are tied to concrete moments in a When/Command table.

5 / 5

Progressive Disclosure

The body is an overview with all detail pushed one level deep: every one of the 11 unique reference paths cited (specify.md, implement.md, verify-screens.md, etc.) exists in references/, every script named exists in scripts/, and the Commands tables map trigger patterns to their reference file. References are clearly signaled at their decision points, not buried.

5 / 5

Total

19

/

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 specific description that explicitly answers what the skill does and when to use it, with concrete trigger phrases and a negative-scope clause. The only weakness is a handful of generic one-word triggers (design, tasks, implement) that carry mild overlap risk with adjacent skills.

DimensionReasoningScore

Specificity

Lists multiple concrete, specific actions with comprehensive coverage: "writes testable requirements in EARS notation, atomic tasks with a gate and a commit each", "Ships deterministic Python scripts", "an independent Verifier (author != verifier) spends its time on mutations". There is no vague filler — every clause names a concrete behavior, matching the top anchor rather than the 'several specific actions with minor gaps' of 4.

5 / 5

Completeness

Explicitly answers both questions: the 'what' opens with "Feature planning and implementation with 4 adaptive phases (Specify, Design, Tasks, Execute)" and details behaviors, and the 'when' is fully explicit with "Use when (1) planning features, (2) implementing with verification and atomic commits, (3) validating an implementation against a spec" plus a concrete Triggers list. It even adds negative scope ("Do NOT use for pure architecture decomposition analysis"), going beyond the 4 anchor's weaker 'when'.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are covered comprehensively with synonyms: "specify feature", "discuss feature", "verify work", "UAT", "record decision", "pause work", "resume work", plus "validate"/"verify work" variations for the same intent. Not a 4 because the multi-word phrases are exactly what a user would say when needing this skill, not the generic single keywords the 4 anchor tolerates alongside gaps.

5 / 5

Distinctiveness Conflict Risk

The spec-driven niche is clear and the explicit exclusion "Do NOT use for pure architecture decomposition analysis or standalone technical design documents" plus multi-word triggers keep it mostly distinct. Not a 5 because the bare single-word triggers "design", "tasks", "implement", "validate" are generic and would overlap with general coding/design skills; not a 3 because the exclusion clause and the distinctive multi-word phrases substantially reduce overlap.

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

Path

packages/skills-catalog/skills/(development)/tlc-spec-driven/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.