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. Creates atomic tasks with verification criteria, atomic git commits, and requirement traceability. Features an independent Verifier (author != verifier, evidence-or-zero), persistent decision log (STATE.md), and test-coverage-matrix-driven tests, plus a self-improving lessons layer that turns verification failures into reusable project-local guidance. Stack-agnostic. Use when (1) Planning features (requirements, design, task breakdown), (2) Implementing with verification and atomic commits, (3) Validating or verifying 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 architecture decomposition analysis (use architecture skills) or technical design docs (use create-technical-design-doc).

75

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable skill body with a clear phased workflow, explicit validation gates and bounded feedback loops, and clean one-level-deep progressive disclosure. The main weakness is token efficiency: the Verifier is restated across sections and the Output Behavior guidance is tangential.

Suggestions

Consolidate the Verifier description: keep a one-line non-negotiable in Critical Rules #4 and defer all mechanics to Sub-Agent Delegation / sub-agents.md rather than restating the full five-step process inline in two places.

Trim or remove the "Output Behavior" section's model-guidance paragraph — it is tangential ceremony that does not advance the spec-driven workflow.

Reconcile the orphaned references/coding-principles.md: either link it from the body (e.g., under a principles/practices pointer) or remove it so the bundle has no dangling files.

DimensionReasoningScore

Conciseness

Mostly dense and procedural with no padding of concepts Claude already knows, but not every token earns its place: the Verifier is described twice (Critical Rules #4 and again in Sub-Agent Delegation), and the "Output Behavior" model-guidance section is tangential ceremony. Not a 3 because of this redundancy and ceremony; not a 1 because it never explains basic concepts.

2 / 3

Actionability

Gives concrete, actionable guidance — exact commands ("python3 scripts/lessons.py list --status confirmed"), the .specs/ directory tree, trigger-to-reference mapping tables, and concrete rules ("One atomic commit per task"). Per the instruction-skill scoring note, absence of code is not penalized when guidance is actionable; not a 2 because nothing is pseudocode or missing key details for its role as a coordinator.

3 / 3

Workflow Clarity

Clear Specify→Design→Tasks→Execute sequence with explicit validation checkpoints ("the gate must pass... before a task is done", always-on Verifier after the last task) and an explicit feedback loop ("fix→re-verify loop is bounded to 3 iterations before escalating"). Not a 2 because checkpoints and retry bounds are explicit, not implicit.

3 / 3

Progressive Disclosure

Clear overview body with well-signaled one-level-deep references (all [name](references/name.md) links resolve to real files), content split by phase plus cross-cutting concerns, and easy navigation via the Commands trigger tables. Not a 2 because references are clearly signaled and one level deep, not inline walls of text; the unreferenced coding-principles.md orphan is a minor nit.

3 / 3

Total

11

/

12

Passed

Description

100%

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, specific description that clearly states what the skill does and when to use it, with an explicit trigger list and "Do NOT use for" guardrails. The only minor weakness is a few overly generic single-word triggers ("design", "tasks", "implement", "validate") that could overlap with other skills.

DimensionReasoningScore

Specificity

Lists many concrete actions — "Creates atomic tasks with verification criteria, atomic git commits, and requirement traceability", "independent Verifier (author != verifier, evidence-or-zero)", "persistent decision log (STATE.md)", "test-coverage-matrix-driven tests", "self-improving lessons layer" — matching the multiple-specific-actions anchor. Not a 2, which only names a domain and some actions without this comprehensiveness.

3 / 3

Completeness

Explicitly answers what (4 adaptive phases, atomic tasks/commits, Verifier, decision log, lessons) and when (numbered "Use when (1)... (2)... (3)..." plus "Triggers on ..."). Not a 2, where the "when" is missing or only implied.

3 / 3

Trigger Term Quality

Provides broad natural-language triggers ("specify feature", "discuss feature", "verify work", "record decision", "pause work", "resume work", "UAT") a user would actually say. Not a 2 because coverage is broad rather than missing common variations, though a few single-word triggers ("design", "tasks") are terse.

3 / 3

Distinctiveness Conflict Risk

Clear niche (spec-driven 4-phase feature dev) with explicit de-confliction guardrails: "Do NOT use for architecture decomposition analysis (use architecture skills) or technical design docs (use create-technical-design-doc)." Not a 2 because the negative-scope guidance sharply reduces overlap, though the single-word triggers are a mild residual risk.

3 / 3

Total

12

/

12

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.

Validation16 / 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.