CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

challenge-requirements

Challenge and clarify requirements before planning or implementing a software change — feature requests, bug reports, specifications, tickets, and proposed solutions. Finds missing outcomes, ambiguous behavior, conflicting constraints, hidden assumptions, unsafe defaults, and untestable acceptance criteria, asks the few questions that matter, and produces a requirements brief with explicit decisions and unresolved blockers. Use only when the user asks to challenge, clarify, or pressure-test requirements, not automatically for every request.

Quality

94%

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, highly actionable instruction-only skill: the workflow is clearly sequenced with explicit validation checkpoints and feedback loops, and guidance is concrete down to exact commands, labels, and handoff syntax. Its weaknesses are length with some repeated calibration guidance and zero use of external reference files for the sizable checklists and brief template.

Suggestions

Consolidate the repeated depth-calibration guidance (sections 1, 5 intro, and the completion rule all warn against forcing every request through the same checklist) into a single statement.

Move the section 5 challenge-dimension checklists or the section 12 brief template into a references/ file, keeping SKILL.md to the core workflow with explicit pointers.

Trim the knackpack-specific paragraphs in sections 9 and 12 to the essential rule; the environment-conditional clauses make these sections dense without adding guidance for users without knackpack.

DimensionReasoningScore

Conciseness

Mostly lean, directive prose with no explanation of concepts Claude already knows ('Never invent business rules or silently turn assumptions into requirements', 'Silence is not approval'), but at ~475 lines some calibration advice repeats — 'Do not force every request through the same checklist' recurs in sections 1, 5, and the completion rule — and the knackpack-specific paragraphs are dense. Not 5 because of this redundancy; not 3 because there is no opinion padding or teaching of known concepts.

4 / 5

Actionability

Concrete, executable guidance throughout: working record labels (CONFIRMED REQUIREMENT, OBSERVED BEHAVIOR, CONSTRAINT, ASSUMPTION, PROPOSAL, OPEN DECISION), a three-way uncertainty classification (BLOCKING / NONBLOCKING ASSUMPTION / DEFERRED), copy-paste commands ('mkdir -p -m 700 <folder>' with a verify-and-stop check), a weak-vs-stronger acceptance-criteria example, and an exact handoff command ('/knackpack:plan-implementation Plan from the brief at <absolute path>'). Not 4 because specific examples cover the common cases with no significant gaps.

5 / 5

Workflow Clarity

A clearly sequenced 13-section process (establish maturity → recover problem → investigate → separate facts/decisions → challenge → handle bugs → classify uncertainty → ask → criteria → feasibility → scope → handoff → judgment) with explicit checkpoints: the six-condition completion-rule checklist, 'if the check fails, stop and tell the user', 'Mark criteria that depend on unresolved decisions as provisional', and a 5-step disagreement feedback loop in section 13. Not 4 because validation checkpoints and feedback loops are explicit rather than implicit.

5 / 5

Progressive Disclosure

Well-organized single file with clear numbered sections and headers, no buried or nested references, and easy navigation; however, everything lives inline in one ~475-line file with no reference files — the section 5 challenge-dimension checklists and the section 12 brief template are strong candidates for a references/ file. Not 5 because it exceeds the lean single-file range and uses no progressive disclosure; not 3 because structure and content placement within the file are good.

4 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: third-person voice, multiple concrete actions, comprehensive natural trigger terms, and an explicit 'Use only when' clause with a clear exclusion boundary. It fully answers both what the skill does and when to use it, with minimal conflict risk against adjacent skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage: 'Finds missing outcomes, ambiguous behavior, conflicting constraints, hidden assumptions, unsafe defaults, and untestable acceptance criteria', 'asks the few questions that matter', and 'produces a requirements brief with explicit decisions and unresolved blockers'. Not 4 because both the detection actions and the deliverable are fully enumerated rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both questions: what it does ('Challenge and clarify requirements before planning or implementing a software change… produces a requirements brief') and when to use it ('Use only when the user asks to challenge, clarify, or pressure-test requirements, not automatically for every request'). Not 4 because the when-clause is fully explicit with concrete trigger phrases, not merely present.

5 / 5

Trigger Term Quality

Natural trigger phrases a user would actually say are present: 'challenge, clarify, or pressure-test requirements', plus input synonyms 'feature requests, bug reports, specifications, tickets, and proposed solutions'. Not 4 because synonym coverage across both trigger verbs and input artifact types is comprehensive for this domain.

5 / 5

Distinctiveness Conflict Risk

Clear niche (requirements analysis before implementation) with an explicit exclusion boundary — 'not automatically for every request' — that separates it from general planning, implementation, or code-review skills. Not 4 because the boundary is stated explicitly rather than left implicit, leaving minimal overlap risk.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

bezmoradi/knackpack

Path

skills/challenge-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.