Claude-skill-registry ext-outline-docs

Outline extension implementing protocol for documentation domain

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/ext-outline-docs" ~/.claude/skills/majiayu000-claude-skill-registry-ext-outline-docs && rm -rf "$T"

manifest: skills/data/ext-outline-docs/SKILL.md

source content

Documentation Outline Extension

Extension implementing outline protocol for documentation domain.

Provides domain-specific knowledge for deliverable creation in documentation tasks. Implements the outline extension protocol with defined sections that phase-3-outline calls explicitly.

Domain Detection

This domain is relevant when:

```
doc/
```
or
```
docs/
```
directory exists
Request mentions "AsciiDoc", "ADR", "interface specification", "documentation"
Files have
```
.adoc
```
extension
Request mentions updating README or technical documentation

Assessment Protocol

Called by: phase-3-outline Step 3 Purpose: Determine which workflow applies (simple vs complex)

Workflow Selection Criteria

Indicator	Result	Rationale
Single document update	simple	Isolated change
ADR creation with supersedes	simple	Logically one unit
Interface spec with code traceability	simple	One deliverable for spec
Cross-document refactor	complex	Multiple files affected
Documentation sync with code	complex	Dependencies on code deliverables
"reorganize" keyword	complex	Cross-cutting structure change

Conditional Standards

None - documentation domain has no additional standards to layer.

Simple Workflow

Called by: phase-3-outline Step 4 (when assessment = simple) Purpose: Create deliverables for isolated documentation changes

Domain-Specific Patterns

Grouping Strategy:

Scenario	Grouping
Single document update	One deliverable
ADR creation with related updates	One deliverable for all related ADRs
Interface spec with code traceability	One deliverable for spec, separate for code

Change Type Mappings:

Request Pattern	change_type	execution_mode
"add", "create", "new" ADR/doc	create	automated
"update", "fix" documentation	modify	automated
"supersede" ADR	modify	automated

Standard File Paths:

ADRs:
```
doc/adr/ADR-NNN-{title}.adoc
```
Interfaces:
```
doc/interfaces/IF-NNN-{title}.adoc
```
Architecture:
```
doc/architecture/{topic}.adoc
```
General:
```
doc/{topic}/
```
README:
```
README.md
```
or
```
README.adoc
```

Verification Commands:

AsciiDoc validation: Check for proper formatting and structure
Link verification: Validate all internal cross-references
ADRs: Check ADR numbering sequence and status consistency
Interfaces: Check interface numbering and completeness

Complex Workflow

Called by: phase-3-outline Step 4 (when assessment = complex) Purpose: Create deliverables for cross-document changes

Domain-Specific Patterns

Grouping Strategy:

Scenario	Grouping
Documentation sync with code	Doc deliverable depends on code deliverable
Reorganize docs	One deliverable per logical section

Change Type Mappings:

Request Pattern	change_type	execution_mode
"reorganize" docs	refactor	manual
"sync" with code	modify	automated

Batch Analysis:

Process related documents together (e.g., ADR and its superseded docs)
Check cross-references when modifying any document
Validate heading hierarchy in modified documents

Discovery Patterns

Called by: Both workflows during file enumeration Purpose: Provide domain-specific Glob/Grep patterns

Grep Patterns

Change Type	Discovery Command
Broken xrefs	`grep -r 'xref:' doc/*.adoc`
ADR supersedes	`grep -r 'Superseded by' doc/adr/`
Interface refs	`grep -r 'IF-[0-9]' doc/`
README links	`grep -r '\[.\](.\.adoc)' README.md`

Glob Patterns

Component Type	Glob Pattern
All AsciiDoc	`doc/*/.adoc`
ADRs	`doc/adr/ADR-*.adoc`
Interfaces	`doc/interfaces/IF-*.adoc`
Architecture	`doc/architecture/*.adoc`

Comprehensive Discovery

For cross-cutting documentation changes:

# Find all AsciiDoc files
find doc/ -name "*.adoc" -type f

# Check ADR sequence
ls -1 doc/adr/ADR-*.adoc 2>/dev/null | sort

# Check interface specs
ls -1 doc/interfaces/IF-*.adoc 2>/dev/null | sort