ai-docs

Write AI-scannable documentation with TL;DRs, tables, and one concept per file.

16|1|Updated Jan 2, 2026

Search Tags:#documentation #ai-friendly #guides #md #ai-docs

One-click install

npx skills add https://github.com/michalvavra/agents --skill ai-docs-michalvavra

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: ai-docs
Source: https://github.com/michalvavra/agents/tree/main/skills/ai-docs
Command: npx skills add https://github.com/michalvavra/agents --skill ai-docs-michalvavra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI Documentation provides guidance to write AI-scannable documentation that is concise, actionable, and consistent for AI agents.

Core Features & Use Cases

TL;DR and limits: Keep files under 150 lines; place a TL;DR at the top.
Structured data: Use tables for parameters, examples, and a commands cheatsheet.
One concept per file: Separate reference docs from how-to guides; reference code.

Quick Start

Create {noun}.md reference docs and {verb}-{noun}.md how-to guides that document a concrete feature, including JSON examples and commands.