CtrlK
BlogDocsLog inGet started
Tessl Logo

intent

Turn an open-ended idea into a PRD plus a runnable definition of done. Use when a developer wants to start a new feature, "file a PRD", "spec out" or "scope" an idea, think through what to build, or kick off the harness for a piece of work. Produces prds/<feature>/prd.md + an executable prds/<feature>/run-prd-test.sh on a prd/<author-slug>/<feature> branch. The one human-attentive skill in the chain.

73

Quality

92%

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

The canonical home for this skill is intent in tdg-ninja/context-specs-factory-ai

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.

Excellent content structure: a fully sequenced workflow with validation gates and an explicit error-recovery loop, copy-paste-ready commands, and clean one-level-deep progressive disclosure to four real reference files. The only notable cost is the prose-heavy nine-principle philosophy section, which justifies the skill's design at some length that a leaner statement could carry.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely skill-specific discipline (harness contracts, artifact coupling, right-reason loop) with little that Claude already knows — above the score-3 anchor with only 'some unnecessary explanation'. A few spots could be trimmed: the nine-principle philosophy section spends tokens justifying the design ('Don't recite them — *embody* them... teach it as you work') and P9's 'Explain → confirm → act → take feedback' restates behavior already implied elsewhere, so it falls just short of the score-5 'every token earns its place' anchor.

4 / 5

Actionability

Guidance is fully executable: Step 7 gives copy-paste-ready git commands (`git checkout -b prd/<author-slug>/<feature>`, `git add prds/<feature>/`), Step 6 gives the exact command (`chmod +x prds/<feature>/run-prd-test.sh` and run it), Step 0 names the derivation source (`git config user.email`), and every step points to the specific reference file that operationalizes it. This matches the score-5 anchor; score 4 would understate the concreteness of the commands and per-step file routing.

5 / 5

Workflow Clarity

Steps 0–7 are clearly sequenced with explicit validation checkpoints and a feedback loop: the Step 3 decide-to-build gate, Step 6's iterate-until-every-failure-shape-matches loop with exit-code reading and wrong-reason diagnosis, and Step 7's 'With the user's confirmation'. This matches the score-5 anchor (clear sequence, explicit validation, error-recovery loop); score 4 would ignore the fully specified right-reason feedback loop.

5 / 5

Progressive Disclosure

The body is a clear overview that appropriately defers detail to four real, one-level-deep references, each clearly signaled with what it contains and when to read it ('Read the two seam references before and during the conversation'; 'the two artifact references when you reach the build'). All four referenced files exist in references/ with no nested reference chains. This matches the score-5 anchor; no content that belongs in a reference is inlined in the main body.

5 / 5

Total

19

/

20

Passed

Description

88%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 that explicitly answers both what and when with concrete artifacts, file paths, and several natural trigger phrases. Voice is third person and there is no fluff. Minor room to improve: add a few more trigger synonyms (e.g. 'write a spec', 'requirements') and the generic 'start a new feature' trigger carries slight overlap risk with general planning skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions and outputs: 'Turn an open-ended idea into a PRD plus a runnable definition of done' and 'Produces prds/<feature>/prd.md + an executable prds/<feature>/run-prd-test.sh on a prd/<author-slug>/<feature> branch.' Every capability named is specific and verifiable, matching the 'multiple specific concrete actions; comprehensive coverage' anchor rather than the score-4 anchor's 'minor gaps in coverage'.

5 / 5

Completeness

Both questions are answered explicitly: 'what' via 'Turn an open-ended idea into a PRD plus a runnable definition of done' plus the concrete artifact list, and 'when' via 'Use when a developer wants to start a new feature, "file a PRD", "spec out" or "scope" an idea, think through what to build, or kick off the harness.' This matches the score-5 anchor exactly and is above the score-4 anchor where the 'when' could be more explicit.

5 / 5

Trigger Term Quality

Strong natural trigger phrases users would actually say: 'file a PRD', 'spec out', 'scope' an idea, 'think through what to build', 'kick off'. A few common variations (e.g. 'write a spec', 'requirements doc') are missing, which fits the score-4 anchor ('good keyword coverage; a few natural terms missing') rather than the comprehensive score-5 anchor; score 3 would undervalue the multiple explicit synonyms present.

4 / 5

Distinctiveness Conflict Risk

The PRD/intent-specification niche is clear with distinct trigger phrases ('file a PRD', 'spec out'), so it sits above the score-3 'could still overlap' anchor. However, generic planning triggers like 'wants to start a new feature' or 'think through what to build' have minor overlap risk with general planning/brainstorming skills, which keeps it below the score-5 'minimal conflict risk' anchor.

4 / 5

Total

18

/

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
tdg-ninja/context-specs-claude-code
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.