adr-skill

Name: adr-skill
Availability: InStock
Author: thkt

Convert Architecture Decision Records into project-specific skill files under .claude/skills/.

11|1|Updated Aug 6, 2025

Search Tags:#skill generation #ADR #context-aware #auto-discovery #architecture decision #implementation guidance

Ready to run

npx skills add https://github.com/thkt/claude-config --skill adr-skill

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adr-skill
Source: https://github.com/thkt/claude-config/tree/main/commands/adr
Command: npx skills add https://github.com/thkt/claude-config --skill adr-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs describe decisions but often lack direct, actionable guidance. This Skill converts Architecture Decision Records into context-aware implementation patterns, references, examples, and validation, enabling teams to apply decisions quickly and consistently.

Core Features & Use Cases

Project-specific pattern generation from ADR with references, examples, and validation.
Context-aware guidance for concrete implementation patterns.
Auto-discovery by saving to .claude/skills/ and enabling automatic discovery.

Quick Start

Generate a skill from an ADR by number, then use or preview it:

/adr:skill 0001
/adr:skill 0001 --global
/adr:skill 0001 --preview

Frequently Asked Questions about adr-skill

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

FAQPage Schema

How do I convert Architecture Decision Records into implementation guidance?▼

This Skill translates ADRs into actionable, project-specific implementation patterns. It extracts ADR sections—Title, Context, Decision, Consequences—and generates structured skill artifacts with references, examples, and validation rules stored in .claude/skills/ for immediate application.

Can I auto-discover ADR-based skills in my project workflow?▼

Yes. Generated skills are saved to .claude/skills/ with metadata and triggers, enabling automatic discovery and keyword-triggered activation. Skills activate contextually when relevant ADR patterns match your implementation needs.

How do I generate a skill from an existing ADR?▼

Use the command /adr:skill [number] to generate a skill from an ADR by its number. Use --preview to view before saving, or --global to make it available across projects. Skills are instantly stored and ready for use.

Does this work across different project contexts and languages?▼

Yes. The Skill generates context-aware patterns tailored to your specific project and supports bilingual skill generation, adapting ADR guidance to local development environments and team communication preferences.

What if my team lacks direct implementation patterns from architectural decisions?▼

ADRs often document decisions without actionable steps. This Skill bridges that gap by inferring tool usage, extracting decision rationale, and generating concrete implementation patterns with examples and validation references specific to your architecture.