CtrlK
BlogDocsLog inGet started
Tessl Logo

tlc-spec-lean

Spec-driven feature work that freezes obligations instead of the plan: one human-reviewed plan with EARS criteria, path, entities, interface and one-way doors, then proof-backed checks, then build, then an independent Verifier. Use when the user says "tlc-spec-lean", "plan feature", "specify feature", "write the checks", "build this plan", or "verify work". Do NOT use for standalone design documents unattached to a feature, architecture decomposition analysis, or work that already has a task list or checklist to execute.

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

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 skill body: the four-phase workflow is clearly sequenced with script-enforced validation gates and error-recovery loops, and every phase's detail is correctly pushed to real, one-level-deep reference files. The only weakness is minor rhetorical padding and repetition of the Verifier-dispatch rule across sections, which slightly inflates token cost without adding guidance.

DimensionReasoningScore

Conciseness

Dense, high-signal content with zero explanation of concepts Claude already knows, and no filler hedging. Minor over-explanation remains: the "Why this shape" philosophy section and repeated restatements of the Verifier-dispatch rule (Critical rule 5, Flow→Verify, Sub-agents, Example 2) could be trimmed. Not level 5 because some rhetorical padding ("Freeze the obligations. Free the plan.") and rule repetition is trimmable; not level 3 because there is no genuinely unnecessary explanation.

4 / 5

Actionability

Fully executable guidance: a copy-paste script table ("python3 <skill-dir>/scripts/validate_plan.py <feature>"), a concrete artifact tree (.specs/features/<feature>/plan.md, checks.md, verification.md), three worked examples with numbered actions and results, and cause/solution troubleshooting. All named scripts and reference files exist in the bundle.

5 / 5

Workflow Clarity

Clear four-phase sequence (PLAN → CHECKS → BUILD → VERIFY diagram) with explicit validation checkpoints before each phase (validate_plan.py before presenting, validate_checks.py before building, check_commit.py before each commit, validate_verification.py before declaring done), a feedback loop for error recovery ("Read the script stderr, fix the artifact it named, and re-run the same command"), and a documented degraded path. Matches the level-5 anchor: clear sequence, explicit validation, error-recovery loops.

5 / 5

Progressive Disclosure

The body is an overview holding the pinned cross-phase rules, with each phase's full process one level deep in clearly signaled, verified-existing references (references/plan.md, checks.md, build.md, verify.md, memory.md — all present; reference files link only to siblings and one external URL, no deeper nesting). Scripts and fixtures live in scripts/. Content is appropriately split and easy to navigate.

5 / 5

Total

19

/

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.

A strong description: it states the complete four-phase workflow concretely, provides six natural trigger phrases, and bounds its scope with explicit negative triggers. The only gap is a handful of missing natural synonyms (e.g. "write the spec") that keep trigger coverage just short of comprehensive.

DimensionReasoningScore

Specificity

The description enumerates the full pipeline concretely: "one human-reviewed plan with EARS criteria, path, entities, interface and one-way doors, then proof-backed checks, then build, then an independent Verifier" — multiple specific actions with comprehensive coverage. It uses third-person voice throughout, so no person-voice penalty applies.

5 / 5

Completeness

Explicitly answers both what ("Spec-driven feature work that freezes obligations instead of the plan: ...") and when ("Use when the user says ...") with concrete trigger phrases, plus negative triggers ("Do NOT use for standalone design documents..."). This matches the level-5 anchor exactly; level 4 would require a less explicit 'when'.

5 / 5

Trigger Term Quality

Six explicit triggers ("tlc-spec-lean", "plan feature", "specify feature", "write the checks", "build this plan", "verify work") are phrases a user would naturally say. Not level 5: a few natural synonyms are missing (e.g. "write the spec", "spec out", "review my work"); not level 3 because coverage is genuinely good rather than partial.

4 / 5

Distinctiveness Conflict Risk

Clear niche (spec-driven feature workflow with independent Verifier), a unique skill-name trigger, and explicit exclusion of adjacent use cases ("standalone design documents unattached to a feature, architecture decomposition analysis, or work that already has a task list"). Minimal conflict risk.

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