CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

requirement-convergence

Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from decision-relevant repository evidence. Use when a requirement enters a workflow, before design begins.

Quality

81%

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

The canonical home for this skill is requirement-convergence in shinpr/claude-code-workflows

SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill body is a well-engineered instruction-only protocol: every step has explicit completion evidence, a genuine re-ask feedback loop exists, the quality checklist closes the workflow, and detailed judgment criteria are properly split into a real, well-signaled reference file. The only improvement opportunities are minor: trim a few rhetorical flourishes and add one worked example of a convergence record or rendered Scope Confirmation.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive throughout, teaching a novel protocol rather than concepts Claude already knows; only a few rhetorical flourishes ("delivering exactly what was asked for when what was asked for was wrong", "so the user's judgment survives however the question was put") could be trimmed, matching the efficient-with-minor-trims anchor rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

For an instruction-only skill the guidance is concretely executable: field pass conditions, a four-step hearing table with per-step completion evidence, a sectioned Scope Confirmation template, named storage carriers, and a numbered reference protocol. It stays below anchor 5 because there is no worked example (a sample convergence record or rendered confirmation) covering the common case.

4 / 5

Workflow Clarity

The Hearing Protocol is a clearly sequenced four-step process where every step carries explicit completion evidence as a checkpoint, Step 3 defines a re-ask feedback loop for values that fail their pass condition, and a Quality Checklist closes the process — matching the anchor for clear sequence with explicit validation, error-recovery loops, and checklists. This is an elicitation skill, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The body is a well-organized overview and offloads per-field judgment detail to a single, clearly signaled, one-level-deep reference (references/criteria.md) that is a real file delivering exactly what the link promises (judgment rules, cost inputs, challenge intensity, solution-in-disguise test), matching the clear-overview anchor with no organization gaps found.

5 / 5

Total

18

/

20

Passed

Description

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

The description is specific and complete, clearly stating three concrete capabilities and an explicit timing-based trigger with a distinct niche. Its main weakness is trigger phrasing: it leans on process-internal wording and omits natural synonyms like "scope" or "non-goals" that users would actually say, slightly limiting discoverability and leaving minor overlap risk with adjacent planning skills.

Suggestions

Add natural trigger synonyms to the Use-when clause, e.g. "Use when a requirement or scope statement enters a workflow, before design begins" so users saying "scope" or "requirements" match naturally.

Replace the process-internal phrase "when a requirement enters a workflow" with user-observable conditions, such as "when the user states requirements, exclusions, or asks what a change should deliver".

Mention the confirmation and downstream-consumption capabilities (e.g. rendering a scope confirmation, guiding downstream consumers) to close the minor coverage gap in the what-clause.

DimensionReasoningScore

Specificity

Names three concrete, distinct actions ("Separates the outcome a change must produce from the requirements", "records what the user excluded", "bands cost from decision-relevant repository evidence") with only minor coverage gaps — the hearing/confirmation interaction and downstream consumption rules from the body are omitted, keeping it below the comprehensive anchor 5.

4 / 5

Completeness

Both parts are present: a clear, specific "what" (three concrete actions) and an explicit "Use when a requirement enters a workflow, before design begins" trigger. It falls short of anchor 5 because the when-clause covers a single trigger scenario without enumerated concrete trigger phrases or variations.

4 / 5

Trigger Term Quality

The trigger clause includes the core natural term "requirement" plus phase markers ("workflow", "design", "before design begins"), but misses common synonyms a user would naturally say ("scope", "requirements", "non-goals", "PRD") and "when a requirement enters a workflow" is process-internal phrasing rather than natural user language, matching the anchor for some relevant keywords missing common variations.

3 / 5

Distinctiveness Conflict Risk

The pre-design requirements-convergence niche (outcome/requirement separation, exclusions, cost banding) is mostly distinct with a clear trigger boundary, but generic "requirement" triggers create minor overlap risk with closely related scoping, PRD-writing, or planning skills, so it is not the minimal-conflict anchor 5.

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

shinpr/claude-code-workflows

Path

dev-skills/skills/requirement-convergence/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.