004-write-article

Creates XDRS article documents that synthesize and link Policies, Research, and Skills.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams accumulate many Policies, Research documents, and Skills across scopes, but lack navigable overview documents that connect them. This Skill guides the creation of XDRS-compliant articles that synthesize related decision content into a single readable view without duplicating the source material. ## Core Features & Use Cases - Structured article authoring: Follows the XDRS article standards for scope, type, subject, numbering, naming, and folder placement. - Cross-document synthesis: Researches relevant Policies, Research documents, and Skills, then links to them instead of copying decision text. - Index and back-reference registration: Updates scope/type indexes and adds back-references in the synthesized documents. - Use Case: A developer asks for an overview of how skills work in the project; the Skill produces .xdrs/_local/adrs/principles/articles/001-skills-overview.md linking to the relevant policies and skill files. ## Quick Start Ask the assistant to write an article about a topic in your XDRS project, specifying the intended audience and scope.

Frequently Asked Questions about 004-write-article

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

FAQPage Schema
How do I write an article in an XDRS project?▼

Provide a topic and audience, then the Skill selects the scope, type, and subject, assigns the next article number, researches related Policies and Skills, and writes the article following the XDRS article template with relative links.

What is the difference between an XDRS article and a Policy?▼

An article is a view that synthesizes and links existing Policies, Research, and Skills without making decisions. If the document needs to capture a decision or rule, use the write-policy skill instead, since Policies are the source of truth.

Where are XDRS articles stored and numbered?▼

Articles are saved at .xdrs/[scope]/[type]/[subject]/articles/[number]-[short-title].md. The number is the highest existing article number in that namespace plus one, and numbers are never reused.

What is the word limit for an XDRS article?▼

Articles should stay under 1950 words for readability, with a hard limit of 8000 words. Content approaching the limit should be split into separate chapter articles with series navigation links.

Can an article copy decision text from a Policy?▼

No. Articles must summarize and link to Policies using relative paths, never reproduce decision text verbatim. If a conflict exists between the article and a Policy, the article notes it and defers to the Policy.