008-write-xdrs-doc

Routes XDRS document authoring requests to the appropriate type-specific writing skill.

1|1|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/flaviostutz/xdrs-core --skill 008-write-xdrs-doc-flaviostutz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 008-write-xdrs-doc
Source: https://github.com/flaviostutz/xdrs-core/tree/main/examples/typed-scope/.xdrs/_core/adrs/principles/skills/008-write-xdrs-doc
Command: npx skills add https://github.com/flaviostutz/xdrs-core --skill 008-write-xdrs-doc-flaviostutz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @mermaid-js/mermaid-cli.

What problem does it solve? When you want to create an XDRS document (policy, skill, research, initiative, article, or presentation), you may not know which authoring skill applies or what conventions to follow. This Skill infers the correct document type from your request and delegates to the right specialized skill, ensuring consistent structure and compliance with XDRS standards. ## Core Features & Use Cases - Automatic Type Inference: Detects whether your request is for a Policy (ADR/BDR/EDR), Skill, Research, Initiative, Article, or Presentation document. - Skill Delegation: Reads and follows the full instructions of the target authoring skill, including prerequisites gates and meta-policies for policy documents. - Mermaid Validation: Scans all written files for Mermaid diagrams and validates them with mermaid-cli, reporting errors before saving. - Use Case: Ask to "write an ADR for adopting event-driven architecture" and the Skill routes to the policy skill, applies subject and numbering rules, and validates any diagrams in the output. ## Quick Start Ask the assistant to write an XDRS document, such as "create a research document analyzing database options for our platform".

Frequently Asked Questions about 008-write-xdrs-doc

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

FAQPage Schema
How do I write an XDRS policy or ADR document?▼

Describe the decision, rule, or standard you want to record, and the Skill infers it is a Policy document. It then loads the policy writing skill, applies subject and numbering meta-policies, and follows all authoring phases.

What types of XDRS documents can this skill create?▼

It supports six document types: Policy (ADR/BDR/EDR), Skill, Research, Initiative, Article, and Presentation. Each type routes to a dedicated authoring skill with its own structure and phases.

What happens if the document type is ambiguous?▼

The Skill asks one focused question listing the six supported types and waits for your answer before proceeding. It only asks when the type cannot be confidently inferred from your request.

Does the skill validate Mermaid diagrams in documents?▼

Yes. After the delegated skill finishes, it extracts every Mermaid code block to a temporary file and runs mermaid-cli validation. Failures are reported so you can correct the diagram before saving.

Can I create a document type not in the routing table?▼

No. The Skill explicitly refuses to create document types outside the six listed in its routing table, ensuring all output conforms to the XDRS framework's defined document types.