What summary statistics are provided?

The skill calculates the total count of ADRs and provides a breakdown of how many are currently Accepted, Superseded, or Deprecated.

Does it support custom metadata like 'Domain'?

Yes, the skill includes an extended table format that captures and displays domain tags if they are defined in your ADR files.

Where does the skill look for ADR files?

The skill specifically scans for markdown files following the numeric pattern [0-9]{4}-*.md inside the docs/adrs/ directory.

Can it handle different ADR formats?

Yes, it is designed to extract metadata from both standard Markdown headers (like ## Status) and YAML frontmatter fields (like status:).

How do I update my project README with this list?

You can run the skill to generate the markdown table and then pipe or copy the output directly into your project's documentation files.

ADR Index Generator

Name: ADR Index Generator
Author: laurigates

bylaurigates

•

学习与文档

Generates a dynamic markdown table and summary of all Architecture Decision Records within a project's documentation.

This skill automates the management of Architecture Decision Records (ADRs) by scanning the docs/adrs/ directory to build a comprehensive index. It intelligently parses ADR files—supporting both Markdown headers and YAML frontmatter—to extract key metadata such as title, status, date, and domain. Beyond listing, it provides summary statistics on record statuses (Accepted, Superseded, Deprecated), making it an essential tool for maintaining architectural transparency and keeping project READMEs up to date.

主要功能

01Automatic discovery of ADR files in the docs/adrs/ directory

02Multi-format parsing for Markdown headers and YAML frontmatter metadata

03Support for extended tables including domain-specific categorization

0410 GitHub stars

05Dynamic Markdown table generation including ADR number, status, and date

06Summary statistics for Accepted, Superseded, and Deprecated decisions

使用场景

01Automatically updating the ADR index in a project's main README or documentation site

02Onboarding new team members by providing a quick, searchable overview of project evolution

03Auditing the current status of architectural decisions during code reviews or system design

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins blueprint-adr-list

For use in Claude.ai and ChatGPT

Download Skill