CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tlc-discover

Thinks through new or large projects: turns a vague idea into a design doc with a clear product problem and the technical solution. Use when exploring a new project, planning or designing a big project or system, or asked for a "design doc". Do NOT use for clear features or projects (use tlc-spec-lean or tlc-spec-driven).

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 dense, highly disciplined methodology skill: the workflow is clearly sequenced with genuine gates and validation loops, and the guidance is concrete enough to execute without guessing. Its main weakness is token efficiency — an over-written rhetorical style and triple coverage of the same rules (rules → phases → failures) make the body far longer than its content requires — and a secondary one that the body keeps nearly everything inline rather than splitting more into the (well-signaled) bundle files.

Suggestions

Rewrite the rhetorical flourishes as plain directives (e.g. 'manufacturing a decision that has all the authority of one and none of the examination' → 'presenting an unexamined solution as a decision'), which could cut the body by roughly a third without losing any rule.

Deduplicate the triple coverage: state each rule once in its phase section and reduce 'Common failures' to one-line pointers ('see Critical rules, #4'), or move the failures catalog to a one-level-deep reference file.

Trim examples inside the body where two illustrate the same point (e.g. the 'a decision that reads settled and is not' idea appears under both rule 6 and 'When to stop deciding').

DimensionReasoningScore

Conciseness

The body (~11,000 words) contains no padding about concepts Claude already knows — every paragraph carries skill-specific methodology — but the rhetorical style ('manufacturing a decision that has all the authority of one and none of the examination', 'the ceremony wearing an apology') roughly doubles the tokens a leaner phrasing would need, and the same rules are covered three times: stated in 'Critical rules', elaborated in the phase sections, then restated in 'Common failures' (e.g. the 'missing number is not evidence' point appears in rules 4, Evidence, and the failures section). This matches anchor 3 ('mostly efficient but... could be tightened') rather than 2, because the substance is not unnecessary explanation of known concepts, only over-written expression.

3 / 5

Actionability

For an instruction-only skill the guidance is exceptionally concrete: exact question sets per problem kind ('who hurts', 'what it costs today', 'what happens if nothing changes'), a copy-paste-ready validator command ('python3 <skill-dir>/scripts/validate_design.py .design/<name>.md' with the Windows fallback spelled out), a fixed decision grid, explicit status vocabularies ('clear', 'blocked by', 'rfc', 'spike', 'design'), and word budgets ('about 2,000 words... about 4,000, plus about 250 for each slice beyond eight'). Three worked examples (open decision, already committed, wrong skill) map user input → actions → result, covering the common cases. Per the scoring note, absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The multi-step process is explicitly sequenced ('SITUATION → PROBLEM → VERDICT → DECIDE') with the ordering rationale given, a hard gate ('Then stop. The user confirms before a single technical option is discussed'), and a dedicated validation section: run the validator, 'Fix every error', hand to a fresh reader, 'Check each finding before accepting it, fix what holds and run the validator again', plus a judgment checklist and a stopping rule. This is the anchor-5 pattern: clear sequence, explicit validation steps, feedback loops for error recovery, and checklists for a complex process.

5 / 5

Progressive Disclosure

The bundle is well used: 'references/document-format.md' (verified to exist, 2,390 words, one level deep — it points back to SKILL.md rather than nesting further) and 'scripts/validate_design.py' are both real, and load timing is explicitly signaled ('Read references/document-format.md when you write the .design/<name>.md artifact — after the verdict is confirmed... Do not load it during the interview'). Scored against anchor 4 rather than 5 because the main body itself is a ~11,000-word monolith — material such as the ~60-line 'Common failures' catalog and the detailed slice-authoring rules could plausibly live in one-level-deep reference files, leaving SKILL.md closer to an overview.

4 / 5

Total

17

/

20

Passed

Description

82%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 answers what and when explicitly, uses natural third-person trigger phrasing, and includes negative guidance that routes clear-feature work to sibling skills. Its only real limitation is that the capability is expressed as a single composite action rather than a list of several concrete actions, which keeps specificity at the middle anchor.

DimensionReasoningScore

Specificity

The description names the domain ('new or large projects') and one composite concrete action — 'turns a vague idea into a design doc with a clear product problem and the technical solution' — which names the deliverable and its two contents. It matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than 4, because it does not list several distinct actions (the PDF-skill anchors' 'extracts, fills, merges' pattern), and it is well above anchor 2 since the action is specific rather than generic. Third person is used ('Thinks through', 'turns'), so no voice penalty.

3 / 5

Completeness

Both halves are explicit: the 'what' ('turns a vague idea into a design doc with a clear product problem and the technical solution') and a concrete 'when' clause ('Use when exploring a new project, planning or designing a big project or system, or asked for a "design doc"') with literal trigger phrases. It additionally supplies negative guidance ('Do NOT use for clear features or projects'), matching anchor 5 ('clearly and explicitly answers both what AND when with concrete trigger phrases') rather than 4, whose 'when' is merely present but less specific.

5 / 5

Trigger Term Quality

Natural user phrasings are present and varied: 'exploring a new project', 'planning or designing a big project or system', and the quoted 'asked for a "design doc"' — all things a user would plausibly say verbatim. This fits anchor 4 ('good keyword coverage; a few natural terms missing'): common adjacent phrasings like 'greenfield project', 'project brief', or 'architecture/design proposal' are absent, so it falls short of anchor 5's comprehensive synonym coverage, but it clearly exceeds anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — upstream discovery/design-doc production for new or large projects — and actively disambiguates from its closest siblings: 'Do NOT use for clear features or projects (use tlc-spec-lean or tlc-spec-driven)'. That explicit routing-away is exactly what anchor 5 asks for ('clear niche with distinct triggers; minimal conflict risk'); anchor 4 ('minor overlap risk with closely related skills') is beaten because the closely related skills are named and excluded by name.

5 / 5

Total

17

/

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