skills.rest
thkt
thktCOMMUNITY
Explore all skills by this author →
GitHub

adr-skill

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
One-click install
npx skills add https://github.com/thkt/claude-config --skill adr-skill
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
abdullah1854abdullah1854
1

algorithmic-art

Generate dated Markdown ADRs with Context, Decision, Consequences, Alternatives, and References.

Community
Intermediate
Accelerated-InnovationAccelerated-Innovation
20

adr-author

Create Markdown Architecture Decision Records from user requests.

Official
Advanced
nettenette
41

commit-messages

Validate commit messages against a standardized format before commits.

Official
Basic
zoraxlzoraxl
3

wiki-adr

Create standardized architecture decision records within a structured wiki-zone hierarchy.

Community
Intermediate