documentation-templates

Standardize README, API reference, and code comment documentation templates.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Icebane84/Synarche_Workshop --skill documentation-templates-icebane84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-templates
Source: https://github.com/Icebane84/Synarche_Workshop/tree/main/.agent/skills/dev/documentation-templates
Command: npx skills add https://github.com/Icebane84/Synarche_Workshop --skill documentation-templates-icebane84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves inconsistent documentation that slows down onboarding, confuses contributors, and makes maintenance harder.

Core Features & Use Cases

  • README Structure Templates: Provides a priority-ordered README outline for projects, including Quick Start, Features, Configuration, API Reference, Contributing, and License.
  • API Documentation Templates: Supplies per-endpoint documentation formatting with parameters, responses, and examples.
  • Code Comment & AI-Friendly Documentation Guidance: Offers JSDoc/TSDoc comment templates and guidance for llms.txt and MCP-ready, RAG-indexable structure.
  • Changelog and ADR Templates: Standardizes changelogs using Keep a Changelog style and records architectural decisions with ADR structure.
  • Documentation Mandate (IPPD Shadow-Logging): Requires every execution to generate a SELT Shadow Log under the canonical UIP-V15 header for provenance consistency.

Quick Start

Ask an AI to generate a new project README, API docs skeleton, and code comment examples using the documentation-templates guidelines for a repository that already has an existing codebase.

Frequently Asked Questions about documentation-templates

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

FAQPage Schema
How do I standardize project README structure and API documentation for consistent onboarding?

Standardize project README and API documentation by applying priority-ordered outlines covering Quick Start, Features, Configuration, and per-endpoint formatting with parameters, responses, and examples. This ensures consistent onboarding materials and contributor guidance across software repositories.

What's the best way to format code comments for RAG indexing and AI-friendly documentation?

Format code comments for RAG indexing using JSDoc and TSDoc comment templates alongside llms.txt and MCP-ready structures. This approach creates searchable context that enables AI tools to discover and retrieve documentation content efficiently during retrieval-augmented generation workflows.

How do I create architecture decision records and changelogs that follow standard conventions?

Create architecture decision records using ADR structure and standardize changelogs using Keep a Changelog style conventions. These templates record architectural decisions and document version changes consistently, making maintenance and contributor onboarding significantly easier for software repositories.

Can I use these documentation templates for an existing codebase that needs consistent contributor guidance?

These documentation templates work for existing codebases by asking an AI to generate README files, API docs skeletons, and code comment examples using the standardized guidelines. They constrain outputs to scannable sections and template formats suitable for repositories needing consistent contributor guidance.

Does standardized documentation structure support YAML frontmatter-driven discovery needs?

Standardized documentation structure supports YAML frontmatter-driven discovery needs by constraining outputs to scannable sections and template formats. This enables operational consistency and makes documentation discoverable for both human contributors and automated indexing systems.

What provenance tracking is required when generating documentation from templates?

Documentation generation requires IPPD Shadow-Logging with UIP-V15 provenance headers, producing a SELT Shadow Log for every execution. This mandatory provenance consistency ensures all template-generated documentation outputs are traceable and operationally auditable across the repository.