arc-refining

Convert design documents into structured XML specifications with acceptance criteria.

6|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/GregoryHo/arcforge --skill arc-refining
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arc-refining
Source: https://github.com/GregoryHo/arcforge/tree/main/skills/arc-refining
Command: npx skills add https://github.com/GregoryHo/arcforge --skill arc-refining

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill transforms unstructured design documents into formal, structured XML specifications, ensuring clarity and preventing downstream invention of requirements.

Core Features & Use Cases

  • Design to Spec Conversion: Converts design documents into authoritative XML specifications.
  • Requirement Formalization: Ensures all requirements have acceptance criteria and are clearly defined.
  • Use Case: When a product manager provides a high-level design document for a new feature, this Skill can be used to create a detailed, machine-readable specification that engineers can then use for implementation planning.

Quick Start

Use the arc-refining skill to convert the design document into a structured XML specification.

Frequently Asked Questions about arc-refining

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

FAQPage Schema
How do I convert a design document into a formal specification?

To convert a design document into a formal specification, you can use a skill that transforms unstructured designs into structured XML specifications. This enforces checklist validation and iterative refinement to ensure all requirements have clear acceptance criteria.

What is the best way to formalize requirements with acceptance criteria?

Formalizing requirements with acceptance criteria is achieved by transforming high-level designs into structured XML specifications. This process prevents downstream invention of requirements by enforcing checklist validation and asking clarifying questions for iterative refinement.

Can I use structured XML specifications as the authoritative source of truth for engineering planning?

Yes, structured XML specifications serve as the authoritative source of truth for downstream processes. Converting design documents into this formalized XML format ensures engineers receive clear, machine-readable requirements for implementation planning without ambiguity.

How do I ensure all my product design requirements are clearly defined for engineers?

To ensure all product design requirements are clearly defined, you should convert them into structured XML specifications. This formalization uses checklist validation and clarifying questions to iterate until every requirement has explicit acceptance criteria.

Why does requirement formalization require iterative refinement through clarifying questions?

Requirement formalization requires iterative refinement through clarifying questions to prevent downstream invention of requirements. Asking clarifying questions ensures every requirement has defined acceptance criteria before the final structured XML specification is generated.

Do I need unstructured design documents to generate machine-readable XML specifications?

Yes, you need an unstructured design document as the initial input to generate machine-readable XML specifications. The skill processes this high-level design input and formalizes it into structured XML to serve as the authoritative source of truth.