human-docs-generator

Generate role-based human documentation from AI state and system changes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Brownbull/ayni_core --skill human-docs-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: human-docs-generator
Source: https://github.com/Brownbull/ayni_core/tree/main/.claude/skills/human-docs-generator
Command: npx skills add https://github.com/Brownbull/ayni_core --skill human-docs-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generating concise, role-specific documentation from complex AI state changes, epic outcomes, and architectural decisions to keep teams aligned and informed, typically under 1000 words per doc.

Core Features & Use Cases

  • Creates role-specific guides for developers, QA, DevOps, product managers, and business stakeholders.
  • Triggers documentation regeneration on epic completion, breaking changes, architectural decisions, or deployments.
  • Provides ready-to-use templates and structured sections (overview, API/architecture changes, deployment notes, user guides).
  • Ensures current-state documentation focused on immediate needs with quickstart guidance.

Quick Start

Run the generator after a significant change to produce updated role-based documentation.

Frequently Asked Questions about human-docs-generator

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

FAQPage Schema
How do I generate role-specific documentation for developers and QA after epic completion?

To generate role-specific documentation after epic completion, trigger the generator to produce targeted guides for developers, QA, DevOps, and product managers. It outputs concise, current-state docs under 1000 words covering API changes, deployment notes, and user guides.

What is the best way to document architecture decisions for different team roles?

The best way to document architecture decisions for different roles is using automated role-based generation. It creates structured sections including overviews and deployment notes tailored for developers, DevOps, and business stakeholders, ensuring teams stay aligned under 1000 words per doc.

Can I automate documentation generation for breaking changes and deployments?

Yes, you can automate documentation generation for breaking changes and deployments. The system triggers documentation regeneration upon these events, applying structured input requirements to produce targeted quickstart templates and optional diagrams for immediate team use.

Does the documentation generator support quickstart templates and optional diagrams?

Yes, the documentation generator supports quickstart templates and optional diagrams. It provides ready-to-use templates within structured sections, ensuring current-state documentation focuses on immediate needs with concise outputs under 1000 words per guide.

What limitations exist when generating human docs from AI state changes?

A key limitation is the 1000-word maximum length per generated document, which enforces conciseness but may omit deeper architectural context. Outputs focus strictly on current-state immediate needs, structured sections, and quickstart guidance rather than exhaustive historical analysis.

Do I need structured input to generate role-based documentation for product managers and end users?

Yes, you need structured input to generate role-based documentation for product managers and end users. Satisfying structured input requirements allows the generator to produce concise, current-state guides with deployment notes and user guides tailored to those specific roles.