concise-documentation-ai-kit

What problem does it solve?

Prevents documentation bloat by enforcing a strict target length (32 lines, max 50) and requiring explicit approval before generating longer docs.

Core Features & Use Cases

• Strict length enforcement: Targets 32 lines and blocks output beyond 50 without permission.
• Mandatory approval workflow: If the draft exceeds 50 lines, the skill asks the user to choose between a concise rewrite, an acceptable 32–50 line version, or an exemption request.
• Smart counting rules: Counts real text lines while treating tables and diagrams as exempt and ignoring YAML frontmatter.
• Exemption handling: Respects conciseDoc: false with a user confirmation prompt, while auto-exempting SKILL.md and .agent.md.
• Use cases: Applies to generating or improving READMEs, guides, markdown files, and any documentation likely to exceed the limit.

Quick Start

Ask the AI: "Write a concise README for my project, but keep it to 32 lines and do not exceed 50 lines without my approval."