concise-documentation-ai-kit

Enforce 32-line documentation targets with a 50-line maximum and approval workflow.

Updated May 11, 2026
One-click install
npx skills add https://github.com/ducthang-hub/nw-ai-kit --skill concise-documentation-ai-kit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: concise-documentation-ai-kit
Source: https://github.com/ducthang-hub/nw-ai-kit/tree/main/.agents/skills/concise-documentation-ai-kit
Command: npx skills add https://github.com/ducthang-hub/nw-ai-kit --skill concise-documentation-ai-kit

SYSTEM DOCUMENTATION & REQUIREMENTS

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."

Frequently Asked Questions about concise-documentation-ai-kit

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

FAQPage Schema
How do I enforce line limits when generating markdown documentation?

Markdown line counting rules exempt tables and diagrams while ignoring YAML frontmatter, counting only real text lines. This ensures accurate length tracking for documentation without penalizing structural elements needed for readability.

How do I write a concise README without exceeding a specific line count?

Documentation length enforcement applies to generating or improving READMEs, guides, and markdown files. It targets any generated documentation likely to exceed the line budget, including cases where users ask about verbosity or line counts.

Can I bypass the 50-line maximum for markdown files that require more detail?

SKILL.md and .agent.md files are automatically exempt from line limits. For other markdown files, set the conciseDoc flag to false and confirm the exemption prompt to bypass the 50-line hard maximum when generating documentation.

What is the best way to keep generated documentation concise and under control?

To prevent documentation bloat, apply strict length enforcement by targeting 32 lines and blocking output beyond 50 lines without permission. This ensures generated markdown files remain concise and readable.

Do tables and diagrams count toward markdown line limits when generating docs?

No, tables and diagrams do not count toward markdown line limits. Line counting rules treat tables and diagrams as exempt and ignore YAML frontmatter, counting only real text lines to enforce the 32-line target and 50-line maximum.