CtrlK
BlogDocsLog inGet started
Tessl Logo

dev-requirements

AI DevKit · Requirements phase guidance for starting features and reviewing requirements. Use when the user wants to capture a new requirement, clarify product scope, initialize feature docs, review requirements, or run dev-lifecycle phases 1-2.

66

Quality

83%

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

88%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 disciplined, token-efficient process skill: every step is concrete and sequenced with explicit validation gates and error-recovery paths. The only weakness is navigation — sibling skills and the README template are referenced by name without paths or a pointer to where they live.

DimensionReasoningScore

Conciseness

The body is a lean imperative checklist with zero concept explanation; every line is operational (e.g. 'Do not assume `docs/ai`; it is only the default docs directory') and assumes Claude's competence, matching the every-token-earns-its-place anchor.

5 / 5

Actionability

Concrete, executable commands appear throughout (`npx ai-devkit@latest lint --feature <name>`, `init -a -e claude --built-in --yes`, `docs init-feature <name>`, `.ai-devkit.json` `paths.docs` fallback), but sibling skills (`dev-worktree`, `dev-planning`, `memory`, `task`) and 'the `README.md` template' are referenced by name without paths, leaving minor gaps.

4 / 5

Workflow Clarity

The phases are clearly sequenced with explicit validation gates: lint before phase work, a recovery path when lint fails (init then rerun), a hard gate ('Do not create, update, approve, or transition past requirements while material open questions remain'), restated shared understanding, and blocker/next-step reporting — matching the explicit-validation anchor.

5 / 5

Progressive Disclosure

The ~50-line body has no bundle files and is organized into three well-delineated sections, but cross-references to sibling skills and the requirements template are name-only and not clearly signaled paths, so structure is good with minor organization gaps rather than fully clear navigation.

4 / 5

Total

18

/

20

Passed

Description

70%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 solid description with an excellent, explicit trigger clause that clearly bounds the skill to the AI DevKit requirements phase. Its main weakness is the what-clause, which stays abstract ('guidance for') instead of enumerating the concrete actions it performs.

Suggestions

Replace 'Requirements phase guidance for starting features and reviewing requirements' with the concrete actions performed, e.g. 'Clarify and capture feature requirements, initialize AI DevKit feature docs, review and validate requirements docs'.

Add natural synonyms users might say, such as 'requirements gathering', 'write a spec', or 'PRD', to the 'Use when...' trigger clause to improve trigger coverage.

Trim the jargon-heavy trigger 'run dev-lifecycle phases 1-2' or pair it with a plain-language equivalent so users outside the AI DevKit workflow still match it.

DimensionReasoningScore

Specificity

The what-clause 'Requirements phase guidance for starting features and reviewing requirements' names the domain but only 1-2 actions, which are themselves abstract ('guidance', 'starting features'); the concrete action verbs only appear in the when-clause, so it matches the anchor for domain plus 1-2 concrete actions rather than the several specific actions of level 4.

3 / 5

Completeness

Both parts are present — an explicit 'Use when the user wants to...' clause with concrete triggers and a stated what — but the what ('guidance for starting features and reviewing requirements') is vague where the level-5 anchor requires a clearly concrete what; it is above level 3 because the when is fully explicit.

4 / 5

Trigger Term Quality

'capture a new requirement, clarify product scope, initialize feature docs, review requirements' are phrases users would naturally say, but common synonyms like 'requirements gathering', 'write a spec', or 'PRD' are missing and 'run dev-lifecycle phases 1-2' is tool-internal jargon, fitting the good-coverage-with-a-few-gaps anchor.

4 / 5

Distinctiveness Conflict Risk

Scoping to 'AI DevKit' and 'dev-lifecycle phases 1-2' carves out a clear niche with minimal conflict risk, though 'review requirements' could mildly overlap with sibling dev-lifecycle phases or generic review skills, matching the mostly-distinct anchor.

4 / 5

Total

15

/

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
codeaholicguy/ai-devkit
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.