Claude-skill-registry ext-triage-docs

Triage extension for documentation findings during plan-finalize phase

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-triage-docs" ~/.claude/skills/majiayu000-claude-skill-registry-ext-triage-docs && rm -rf "$T"

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

source content

Documentation Triage Extension

Provides decision-making knowledge for triaging documentation-related findings during the finalize phase.

Purpose

This skill is a triage extension loaded by the plan-finalize workflow skill when processing documentation findings (AsciiDoc, ADRs, interface specifications). It provides domain-specific knowledge for deciding whether to fix, suppress, or accept findings.

Key Principle: This skill provides knowledge, not workflow control. The finalize skill owns the process.

When This Skill is Loaded

Loaded via

resolve-workflow-skill-extension --domain documentation --type triage

during finalize phase when:

AsciiDoc validation errors occur
Broken cross-references are detected
ADR format issues are found
Interface specification validation fails
Link validation errors occur

Standards

Document	Purpose
suppression.md	AsciiDoc and markdown suppression syntax
severity.md	Documentation-specific severity guidelines

Extension Registration

Registered in marshal.json under the documentation domain:

"documentation": {
  "workflow_skill_extensions": {
    "triage": "pm-documents:ext-triage-docs"
  }
}

Quick Reference

Suppression Methods

Finding Type	Syntax
AsciiDoc lint	`// asciidoc-lint-disable: rule-name`
Link check	`// skip-link-check`
ADR format	Document in ADR metadata
Markdown lint	`<!-- markdownlint-disable MD001 -->`

Decision Guidelines

Severity	Default Action
Broken link	Fix (mandatory)
Invalid cross-reference	Fix (mandatory)
Format inconsistency	Fix or accept with justification
Style warning	Accept (low priority)

Acceptable to Accept

Draft documentation pending review
External links to third-party sites (with skip annotation)
Legacy documentation pending migration
Generated documentation from code
Historical ADRs with outdated format