clarify

Clarify ambiguous feature specifications into testable requirements with a clarification log.

96|5|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/ArvorCo/Relentless --skill clarify-arvorco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/ArvorCo/Relentless/tree/main/.claude/skills/clarify
Command: npx skills add https://github.com/ArvorCo/Relentless --skill clarify-arvorco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ambiguities in feature specifications slow delivery, cause rework, and increase risk. This skill systematically identifies and resolves unclear requirements to produce precise, testable criteria.

Core Features & Use Cases

  • Ambiguity detection: Scans specs for 10 common ambiguity types (behavioral, data, UI/UX, integration, permission, performance, error handling, state management, edge cases, and testability).
  • Clarifying questions: Generates targeted questions to resolve gaps and align stakeholders.
  • Spec updates & logging: Applies answers to the spec and records a formal clarification log to support traceability and regression testing.
  • Use Case: When a feature spec is vague about acceptance criteria, run this skill to produce concrete acceptance tests and update the spec accordingly.

Quick Start

Provide the path to the target spec (for example relentless/features/NNN-feature/spec.md), run the clarify skill, review generated questions, supply answers, and review the updated spec and clarification-log.

Frequently Asked Questions about clarify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clarify ambiguous feature specifications into testable requirements?

Clarifying ambiguous specifications involves scanning for common ambiguities, prompting targeted clarifying questions, and updating the spec with verifiable acceptance criteria to align stakeholders.

What types of ambiguities should I look for when reviewing software requirements?

When reviewing software requirements, look for 10 common ambiguity types including behavioral, data, UI/UX, integration, permission, performance, error handling, state management, edge cases, and testability issues to ensure precise outcomes.

How do I write testable acceptance criteria from vague feature specs?

To write testable acceptance criteria from vague feature specs, apply a guided question process to surface unclear requirements, then document the answers in a formal clarification log to support traceability and regression testing.

Does this requirements clarification process support traceability for regression testing?

Yes, the requirements clarification process supports traceability by applying answers to the spec and recording a formal clarification log, ensuring that updated, concrete criteria support future regression testing efforts.

What is the best way to resolve gaps and align stakeholders on feature specifications?

The best way to resolve gaps and align stakeholders on feature specifications is to systematically identify unclear requirements, generate targeted clarifying questions, and apply the resolved answers directly into the specification document.