003-write-skill

Creates XDRS-compliant skill packages with correct frontmatter, scope, and numbering.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams maintaining XDRS decision-record repositories need new agent skills that follow strict structural standards, but manually determining type, scope, subject, numbering, and frontmatter format is error-prone and leads to duplicated or misplaced skills. ## Core Features & Use Cases - Guided Skill Authoring: Walks through phased instructions covering scope placement, prerequisites gating, type/scope/subject/number selection, and SKILL.md drafting. - Standards Enforcement: Consults the canonical XDRS standards documents to validate naming, numbering, folder placement, and frontmatter format before writing files. - Duplication Prevention: Scans existing skills in the target scope and directs the user to extend or reference an existing skill instead of creating a duplicate. - Use Case: A user asks to create a skill for debugging CI pipelines; the skill determines it is an EDR skill in the _local scope under the platform subject, assigns the next available number, and writes a complete SKILL.md with a VS Code symlink. ## Quick Start Ask the agent to create a new skill for your task, for example: create a skill to review API designs following XDRS standards.

Frequently Asked Questions about 003-write-skill

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

FAQPage Schema
How do I create a new agent skill following XDRS standards?▼

Follow the phased workflow: confirm scope placement, read the skill standards and XDRS standards documents, select type, scope, subject, and number, then write the SKILL.md with required frontmatter, instructions, examples, and edge cases.

How do I choose between EDR, ADR, and BDR skill types?▼

Choose EDR for engineering workflows and implementation how-tos, ADR for architectural evaluation and technology selection, and BDR for business process execution. When a goal spans multiple types, pick the one matching the primary activity.

What happens if a skill already exists for my goal?▼

The workflow scans the target scope's skills directory before creating anything. If an existing skill covers the goal, you extend or reference it instead of creating a duplicate.

How is the skill number and directory name determined?▼

Scan the target skills directory for the highest existing number and increment by one, never reusing deleted numbers. The name combines the number with a short kebab-case description, limited to 64 characters.

Can I create skills in external scopes?▼

No. Skills default to the _local scope and must not be created in external scopes, which are identified by files listed in the workspace root .filedist.lock. External scope creation requires explicit user direction.