What is the Documentation Outline skill?

It is an extension for Claude Code that provides domain-specific knowledge for creating and managing technical documentation, specifically focusing on ADRs, interface specs, and AsciiDoc.

How does it handle Architecture Decision Records (ADRs)?

The skill manages the numbering sequence, ensures status consistency, and automates the process of superseding older records with new ones.

Does this skill support AsciiDoc validation?

Yes, it includes verification commands for AsciiDoc formatting, structure, and internal cross-reference validation.

When does the skill trigger a 'complex' workflow?

A complex workflow is triggered during cross-document refactors, documentation reorganization, or when documentation must be synchronized with code deliverables.

Technical Documentation Outliner

Name: Technical Documentation Outliner
Author: cuioss

bycuioss

0•

Learning & Documentation

Automates the structuring and management of technical documentation, ADRs, and interface specifications within Claude Code.

The Documentation Outline skill is a specialized extension for the Plan Marshall orchestration layer that enhances Claude Code's ability to manage complex documentation tasks. It intelligently detects documentation domains—such as AsciiDoc files, Architecture Decision Records (ADRs), and interface specifications—to apply domain-specific standards and workflows. Whether performing simple single-document updates or complex cross-document refactors and code-syncing, this skill ensures consistency through automated link verification, ADR numbering management, and standardized file path enforcement.

Key Features

01Automatic domain detection for AsciiDoc and Architecture Decision Records (ADRs)

020 GitHub stars

03Intelligent workflow selection distinguishing between simple updates and complex refactors

04Comprehensive cross-reference and internal link verification for AsciiDoc files

05Automated ADR management including numbering sequence and status consistency

06Advanced discovery patterns for finding broken references and superseded documents

Use Cases

01Synchronizing technical interface specifications with codebase changes to ensure traceability

02Reorganizing documentation structure across multiple directories while maintaining link integrity

03Maintaining a consistent Architecture Decision Record (ADR) log with automated superseding

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cuioss/plan-marshall ext-outline-docs

For use in Claude.ai and ChatGPT

Download Skill