ar-clarify

Clarify allocated requirements from system requirement documents and generate AR range documents.

3|5|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/pi-ixel/Awesome-Agent-Workflow --skill ar-clarify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ar-clarify
Source: https://github.com/pi-ixel/Awesome-Agent-Workflow/tree/main/skills/ar-clarify
Command: npx skills add https://github.com/pi-ixel/Awesome-Agent-Workflow --skill ar-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires question-tracker, pypdf, pdfplumber, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of clarifying and elaborating on allocated requirements (ARs) from system requirement (SR) design documents or direct inputs, ensuring a comprehensive understanding for subsequent detailed design and development.

Core Features & Use Cases

  • AR Clarification: Extracts and clarifies ARs from SR design documents or direct inputs.
  • Code Analysis: Compares AR descriptions with code to identify discrepancies and missing details.
  • Question Management: Manages a pool of questions to guide users through decision-making points.
  • Documentation Generation: Generates an AR range document with comprehensive information for further development.
  • Use Case: For a complex system, this Skill can help clarify ARs from an SR design document, ensuring all requirements are understood and actionable.

Quick Start

Use the ar-clarify skill to clarify the AR 'AR-001' from the SR design document 'SR-design.md'.

Frequently Asked Questions about ar-clarify

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

FAQPage Schema
How do I clarify allocated requirements from a system design document?

To clarify allocated requirements, you can extract and elaborate on ARs from system requirement design documents or direct inputs. This process identifies discrepancies between requirements and existing code to generate an actionable AR range document.

What is the best way to compare allocated requirements against existing source code?

The best way to compare allocated requirements against source code is through automated code analysis. This process evaluates AR descriptions alongside code to identify missing details and discrepancies for decision-making support.

How do I manage decision-making questions during requirement elaboration?

You can manage decision-making questions during requirement elaboration by using a question tracker. This maintains a pool of targeted questions to guide users through unresolved points in the system design process.

Do I need Python libraries to extract text from SR design documents?

Yes, you need Python libraries like pypdf and pdfplumber to extract text from SR design documents. These dependencies enable the text analysis and code comparison required for comprehensive AR clarification.

Can I generate an AR range document directly from direct text inputs?

Yes, you can generate an AR range document directly from text inputs. The skill processes direct inputs or system requirement design files to produce comprehensive documentation for further development.