How does the skill identify the title of a document?

It scans the file content and extracts the text from the first top-level Markdown heading (e.g., # ADR-0001: Title) to use as the display title.

Can I see if an ADR is accepted or proposed?

Yes, the skill parses the YAML frontmatter of each document to extract and display the 'status' field directly in the generated table.

Does this skill work with any directory structure?

This skill is specifically optimized for the directory structure used in the claude-plugin-design repository, looking for markdown files in standard documentation paths.

What types of documents can the List skill find?

The skill identifies Architecture Decision Records (ADRs) stored in the docs/adrs/ folder and OpenSpec specifications located in the docs/openspec/ folder.

Can I filter the results to only show ADRs?

Yes, you can pass 'adr' as an argument to exclude specifications and only see architecture decisions, or 'spec' to see only specifications.

Architecture Decision & Spec Listing

Name: Architecture Decision & Spec Listing
Author: joestump

byjoestump

•

Learning & Documentation

Lists all architecture decision records (ADRs) and technical specifications within a project to provide a high-level overview of design history.

The Architecture Decision & Spec Listing skill provides a centralized view of a project's technical evolution by scanning documentation directories for ADRs and OpenSpec files. It automatically parses YAML frontmatter to extract statuses and dates, presenting them in a structured table format. This skill is essential for developers and architects who need to quickly understand the current state of project decisions, track the progress of proposed specifications, or onboard new team members to the existing architectural landscape without manually browsing through file trees.

Key Features

01Automated discovery of ADRs and OpenSpec files via directory scanning

02Filtering capabilities to isolate specific document types like ADRs or Specs

03Formatted tabular output for clear readability within the Claude Code terminal

04Metadata extraction including implementation status, dates, and titles

05Chronological and numerical sorting for easy tracking of project history

064 GitHub stars

Use Cases

01Quickly referencing existing architectural patterns to ensure consistency in new feature development

02Auditing the current status of proposed specifications during sprint planning or reviews

03Onboarding new developers who need to review the project's technical history and decisions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joestump/claude-plugin-design list

For use in Claude.ai and ChatGPT

Download Skill