What format does this skill use for ADRs?

The skill uses the MADR (Markdown Architectural Decision Records) format, which is a lean and structured template designed to capture the context and rationale behind architectural decisions.

Does this skill help with organizing existing ADRs?

Absolutely. It automatically maintains a README index in your docs/adr directory, handles sequential numbering, and validates paths to ensure your documentation remains organized.

Can it handle different types of technical decisions?

Yes, it includes four specific templates: technology-selection, architecture-pattern, process-change, and deprecation to ensure the right information is captured for each scenario.

How do I start creating a new ADR?

You can trigger the skill by using the /adr command followed by your topic, or by mentioning keywords like 'Architecture Decision' or 'Design Decision' during your conversation.

ADR Creator

Name: ADR Creator
Author: thkt

bythkt

•

Learning & Documentation

Generates and manages structured Architecture Decision Records (ADRs) using the MADR format through an automated 6-phase workflow.

This skill streamlines the architectural decision-making process by guiding users through a comprehensive 6-phase workflow to create, validate, and index Architecture Decision Records (ADRs). By enforcing the Markdown Architectural Decision Records (MADR) format, it ensures that all technical choices—from technology selection to deprecation—are documented with clear context, alternatives, and consequences. The skill automatically handles duplicate checks, cross-linking, and directory indexing, making it an essential tool for maintaining high-quality technical documentation and team alignment in evolving software projects.

Key Features

013 GitHub stars

02Intelligent duplicate detection and cross-linking between related decisions

03Automatic directory management and README index generation

04Automated 6-phase ADR creation workflow from pre-check to indexing

05Specialized templates for technology selection, architecture patterns, process changes, and deprecations

06Built-in validation for MADR compliance and required sections

Use Cases

01Documenting the rationale and alternatives when choosing a specific framework or library

02Managing the deprecation of legacy systems with structured migration plans and consequences

03Recording changes to team development processes, workflows, or coding standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thkt/claude-config creating-adrs

For use in Claude.ai and ChatGPT

Download Skill