CtrlK
BlogDocsLog inGet started
Tessl Logo

requirements-engineering

Transforms business analyses into epics, features, and tech-agnostic success criteria. Creates handoff documents for the architect. Use this skill when the user mentions "Requirements", "RE", "Define Features", "Create Epics", "User Stories", "Requirements", "Success Criteria", "NFRs", "ASRs", "Acceptance Criteria", or similar. Also when a BA document exists and the next step is the formalization of requirements.

66

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/requirements-engineering/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured process skill that clearly defines the Requirements Engineer role, its inputs/outputs, and workflow phases. Its strengths are the concrete naming conventions, frontmatter examples, hypothesis statement example, and clear handoff ritual. Weaknesses include moderate verbosity that could be trimmed (especially the confirmation block and keywords section), and heavy reliance on external references that aren't bundled for verification.

Suggestions

Remove the Keywords section at the bottom—these are already captured in the skill description/frontmatter and waste tokens.

Tighten the 'Recognized information' confirmation block to a shorter template or move it to a reference file, as it's a large inline block that inflates the main skill.

DimensionReasoningScore

Conciseness

The skill is quite long (~250 lines) and contains some sections that could be tightened—e.g., the Keywords section at the bottom repeats trigger words already in the description, and some procedural details (like the full 'Recognized information' confirmation block) are verbose. However, most content is domain-specific process knowledge Claude wouldn't inherently know, so it's not explaining basic concepts. It falls between efficient and padded.

3 / 5

Actionability

The skill provides concrete file paths, naming conventions, frontmatter YAML examples, specific CLI commands (flow.py), table formats for user stories, and a detailed hypothesis statement example. However, much of the actionability depends on templates and referenced files that aren't provided in the bundle, and some steps remain somewhat abstract (e.g., 'run the forbidden-terms grep' without showing the actual command). Mostly executable but with minor gaps.

4 / 5

Workflow Clarity

The workflow is clearly sequenced across numbered phases (Pre-Phase 0 through Phase 5 Handoff Ritual) with time estimates and explicit validation steps (Phase 5 spot-check, backlog sync chain with binding order, consistency-check). The handoff ritual serves as a strong validation checkpoint. Minor gaps: the validation in Phase 5 is described as a 'spot-check' rather than a mandatory gate, and the feedback loop for fixing issues found during validation could be more explicit.

4 / 5

Progressive Disclosure

The skill appropriately references external files for detailed specs (project-conventions/SKILL.md, templates, graph-invariants.md, tech-agnostic-rules.md, handoff-snippets.md, status-promotion-prompt.md, team-workflow.md). References are one level deep and clearly signaled with file paths. However, without bundle files provided, we can't verify these references exist, and some references are quite numerous which could make navigation challenging. The main content stays at overview level appropriately.

4 / 5

Total

15

/

20

Passed

Description

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

This is a strong skill description that clearly communicates both what the skill does and when to use it. It provides comprehensive trigger terms covering common synonyms and abbreviations in the requirements engineering domain. The only minor weakness is that some listed trigger terms (NFRs, ASRs) aren't explicitly reflected in the 'what it does' portion, creating a slight gap between stated capabilities and trigger scope.

DimensionReasoningScore

Specificity

Lists several specific actions: transforms business analyses into epics/features/success criteria, creates handoff documents for the architect. The mention of 'tech-agnostic success criteria' adds specificity. Minor gaps in coverage (e.g., doesn't mention NFRs/ASRs handling despite listing them as triggers).

4 / 5

Completeness

Clearly answers both 'what' (transforms business analyses into epics, features, success criteria; creates handoff documents) and 'when' (explicit 'Use this skill when...' clause with concrete trigger phrases and a contextual condition about BA documents).

5 / 5

Trigger Term Quality

Comprehensive coverage of natural trigger terms including 'Requirements', 'RE', 'Define Features', 'Create Epics', 'User Stories', 'Success Criteria', 'NFRs', 'ASRs', 'Acceptance Criteria', plus contextual triggers like 'BA document exists'. These are terms users would naturally say.

5 / 5

Distinctiveness Conflict Risk

Fairly distinct with its focus on requirements engineering and BA-to-architect handoff. Minor overlap risk with general project management or business analysis skills, but the specific mention of epics, features, success criteria, and architect handoff narrows the niche well.

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
salemaziel/digital-innovation-agents
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.