CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-requirements

Generates requirements documentation (user stories, acceptance criteria, out-of-scope) for a feature in an AI-native MVP project. Invoke before any implementation of a new feature begins — a feature without requirements documentation should not be built. If the developer mentions wanting to add or implement something new, trigger this skill before any code is written.

Quality

87%

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

75%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-crafted, instruction-only skill body: concrete templates, explicit thresholds rules, verification checklists, and gap-flagging TODO conventions, all at ~100 lines with no bundle dependencies. Scores cluster at 4 rather than 5 due to minor padding, the absence of a worked example, and a workflow that must be assembled from separate sections rather than read as one sequence.

DimensionReasoningScore

Conciseness

The body is efficient — templates, rules, and rationale with little padding — but a few rhetorical flourishes could be trimmed, e.g. "Subjectivity is the enemy here" and "an agent expanding scope feels like helpfulness — it has no way to know it's doing something unwanted". Not score 5: these explanatory asides, while useful, aren't all earning their tokens; not score 3: there is no genuinely unnecessary explanation of concepts Claude already knows.

4 / 5

Actionability

Guidance is concrete and executable: exact file paths (`requirements/{feature-name}/`), copy-paste markdown templates for all three documents, TODO comment patterns to insert, and concrete good/bad criterion examples ("the user completes registration in under 3 steps without consulting help documentation"). Not score 5: no fully worked example of a completed document pair, which would remove remaining ambiguity about story grain and criterion phrasing.

4 / 5

Workflow Clarity

The sequence is clear and includes an explicit pre-write verification checklist ("Before writing, verify: every user story has a corresponding acceptance criterion entry; no acceptance criterion is subjective...") plus developer-confirmation and TODO-flagging checkpoints. Not score 5: the workflow is distributed across Usage / The Three Documents / Where to Find Input / Output sections rather than presented as one ordered sequence, and there is no post-write re-check loop.

4 / 5

Progressive Disclosure

The skill has no bundle files and stays a single ~100-line SKILL.md with well-organized, clearly headed sections; the only external pointers are to project files (`docs/functional/glossary.md`, `docs/constitution.md`), which is appropriate. Not score 5: at this length the three per-document format templates are borderline candidates for reference files, keeping the main body leaner.

4 / 5

Total

16

/

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 names its concrete deliverables, states both what it does and when to invoke it in third-person imperative voice, and defines a distinct trigger niche. The only gap is a few missing natural synonyms (e.g., "spec", "define scope") in the trigger phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete outputs — "(user stories, acceptance criteria, out-of-scope)" — naming the full set of deliverables the skill produces, which comprehensively covers its capability space. Not score 4: no meaningful coverage gaps exist; the three document types are the complete action inventory for this skill.

5 / 5

Completeness

Explicitly answers both questions: what ("Generates requirements documentation (user stories, acceptance criteria, out-of-scope) for a feature in an AI-native MVP project") and when ("Invoke before any implementation of a new feature begins"). This matches the score-5 anchor of a clear what plus concrete, explicit when-clauses.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: "If the developer mentions wanting to add or implement something new, trigger this skill before any code is written" and "Invoke before any implementation of a new feature begins". Not score 5: misses common synonyms a user might say, such as "spec", "requirements", "build a feature", or "define scope".

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — requirements documentation gated before feature implementation in an AI-native MVP project — with triggers ("before any implementation of a new feature begins") that are distinct from general coding or documentation skills. 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

Simonvm9114/flag-feedback

Path

.claude/skills/write-requirements/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.