documentation-specialist

Plan, write, audit, and polish documentation from explicit source evidence.

4|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/danielbaustin/agent-design-language --skill documentation-specialist-danielbaustin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-specialist
Source: https://github.com/danielbaustin/agent-design-language/tree/main/adl/tools/skills/documentation-specialist
Command: npx skills add https://github.com/danielbaustin/agent-design-language --skill documentation-specialist-danielbaustin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It enables teams to bound documentation work to specific targets, ensuring source-backed accuracy and safe publication boundaries.

Core Features & Use Cases

  • Bounded documentation planning, auditing, repair, and polishing within a defined scope.
  • Source-backed edits with a claim ledger, validation steps, and risk disclosures.
  • Use Cases: updating README sections, milestone docs, ADRs, runbooks, onboarding guides, architecture documents, or skill documentation with explicit evidence paths.

Quick Start

Identify the bounded target, gather source evidence, and execute a bounded documentation edit following the defined scope.

Frequently Asked Questions about documentation-specialist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write documentation with source evidence to prevent ungrounded claims?

To write documentation with source evidence, you define a bounded target, gather a required source packet, and execute edits while maintaining a claim ledger for traceable accuracy. This process prevents ungrounded claims by validating every assertion against explicit source evidence.

What is bounded documentation and when do I need it for a README or runbook?

Bounded documentation restricts writing and editing to a specific, defined scope with traceable source evidence and policy constraints. You need it for READMEs, runbooks, or ADRs to ensure accuracy, maintain safe publication boundaries, and prevent unauthorized content expansion beyond the target boundary.

Can I audit and repair existing architecture documents using a claim ledger?

Yes, you can audit and repair existing architecture documents by applying a bounded scope and validating content against a claim ledger. This process identifies ungrounded assertions, adds source-backed evidence paths, and repairs documentation to ensure accuracy and compliance with publication boundaries.

Does milestone documentation require validation steps and risk disclosures?

Yes, milestone documentation requires explicit validation steps and risk disclosures when processed within a bounded scope. Applying source-backed edits and a claim ledger ensures that milestone updates remain accurate, traceable to source evidence, and constrained by defined policy boundaries before publication.

What are the limitations of bounded documentation for onboarding guides?

The primary limitation of bounded documentation is that policy constraints stop publication beyond the defined boundary. If your onboarding guides require expanding scope or adding unvalidated claims outside the gathered source evidence, the bounded approach will block those edits to maintain accuracy.

What's the best way to plan and polish an ADR with traceable evidence?

The best way to plan and polish an Architecture Decision Record is to bound the target, gather explicit source evidence, and execute a documentation edit. This approach uses a claim ledger and validation steps to ensure traceable accuracy and safe publication boundaries.