edit-docs

Evaluate document structure for inverted-pyramid flow, heading skeletons, and scannability.

5|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/sambeau/kanbanzai --skill edit-docs-sambeau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: edit-docs
Source: https://github.com/sambeau/kanbanzai/tree/main/.kbz/skills/edit-docs
Command: npx skills add https://github.com/sambeau/kanbanzai --skill edit-docs-sambeau

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a framework for evaluating and improving the structure and readability of documents, ensuring logical flow and scannability without altering sentence-level prose.

Core Features & Use Cases

  • Enforces inverted-pyramid structure and logical flow
  • Checks heading skeleton, section focus, tone gradient, and wall-of-text risks
  • Applies to technical docs, proposals, reports, and policies to produce actionable feedback

Quick Start

Submit your document and request a structural edit to improve organization, headings, and scannability without altering sentence-level prose.

Frequently Asked Questions about edit-docs

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

FAQPage Schema
How do I improve document structure without rewriting existing prose?

Structural editing improves document organization by enforcing inverted-pyramid flow and clear heading skeletons to enhance scannability, while deliberately preserving your original sentence-level prose and voice.

What is the inverted-pyramid structure for technical manuals and policy documents?

The inverted-pyramid structure for technical and policy documents prioritizes critical information at the top, followed by supporting details. This logical flow ensures readers grasp key points immediately for better scannability.

How do I check a heading skeleton for scannability in a design spec?

Check a heading skeleton in design specs by evaluating section focus, tone gradient, and cross-reference integrity. This identifies wall-of-text risks and ensures headings create a scannable, reader-friendly document outline.

Can I use this structural editing workflow for proposals and reports?

Yes, this structural editing workflow applies to proposals, reports, technical manuals, and policy documents. It evaluates organization against standardized criteria to produce actionable structural feedback for reader-friendly editing.

What are the limitations of structural editing for tone gradient and cross-references?

The limitation of this structural editing approach is that it focuses strictly on organization, tone gradient, and cross-reference integrity. It does not rewrite sentence-level prose, so existing grammatical errors or poor wording remain untouched.