skills.rest
usetheodev
usetheodevCOMMUNITY
Explore all skills by this author →
Website𝕏@usetheodevGitHub

skill-writer

Extract ADRs and recommendations from a blueprint into a candidate SKILL.md.

Updated May 13, 2026
Search Tags:#planning#validation#adr#patterns#blueprint#knowledge-extraction#skill-writer
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill skill-writer-usetheodev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/usetheodev/theo-ui/tree/main/.claude/skills/skill-writer
Command: npx skills add https://github.com/usetheodev/theo-ui --skill skill-writer-usetheodev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extracts load-bearing knowledge from a blueprint and generates a candidate SKILL.md at .claude/skills/generated/{topic}-patterns/. This enables faster validation and structured promotion workflows by capturing ADRs, Recommendations, and citations in a first-class skill scaffold.

Core Features & Use Cases

  • Extract ADRs, Recommendations, and cross-cutting references from a blueprint.
  • Generate a ready-to-validate SKILL.md scaffold for /skill-validator and /skill-register.
  • Preserve source structure and citations to ensure traceability during /to-plan.

Quick Start

Feed the blueprint slug to the writer to generate the candidate SKILL.md from ADRs and references.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I generate a SKILL.md file from a blueprint?▼

A blueprint serves as the input source containing ADRs, Recommendations, and cross-cutting references. The writer extracts this load-bearing knowledge to produce a candidate SKILL.md scaffold without inventing new patterns or citations beyond what is present.

Can I use skill-writer to invent new architecture patterns and citations?▼

No, skill-writer does not invent new patterns or citations. It strictly preserves the ADRs, Recommendations, and cross-cutting references already present in the source blueprint to ensure traceability.

How do I validate a generated SKILL.md scaffold before promotion?▼

To validate a generated SKILL.md scaffold, run the staging artifact through /skill-validator before promotion. This structured workflow ensures the extracted ADRs and citations are ready for /skill-register.

Where does the generated candidate SKILL.md output get saved?▼

The generated candidate SKILL.md output is saved as a staging artifact at .claude/skills/generated/{topic}-patterns/. The topic slug is derived directly from the provided blueprint slug.

What is the best way to extract ADRs and cross-cutting references from a blueprint?▼

The best way to extract ADRs and cross-cutting references is using a dedicated writer that parses the blueprint slug and outputs a ready-to-validate skill scaffold, preserving source structure for faster validation workflows.

Related Skills

Explore More Software Engineering Skills→
Space-DinosaursSpace-Dinosaurs
12

agent-adr-drift-detector

Audit code alignment with documented Architecture Decision Records and generate drift reports.

Official
Advanced
usetheodevusetheodev

skill-validator

Validate candidate SKILL.md files against a fixed 5-check rubric.

Community
Advanced
SimHackerSimHacker
49

debugging

Systematically debug issues by hypothesizing, testing, and tracking evidence.

Community
Advanced
khokskhoks
2

user_custom_strategy_intake

Scaffold custom trading strategy directories and register them in ClaudeTrading configuration.

Community
Intermediate