doc-editing

Guide structured documentation creation with single-type discipline and source verification.

Updated May 4, 2026
One-click install
npx skills add https://github.com/cjohnhanson/almanac --skill doc-editing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-editing
Source: https://github.com/cjohnhanson/almanac/tree/main/skills/doc-editing
Command: npx skills add https://github.com/cjohnhanson/almanac --skill doc-editing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of producing comprehensive and coherent documentation by guiding the user through a structured process, from defining the scope to final review.

Core Features & Use Cases

  • Structured Documentation Process: Guides users through a three-phase process to create well-organized documentation.
  • Type Discipline: Enforces a single Diátaxis type per document to maintain clarity.
  • Reference Verification: Ensures technical accuracy by verifying claims against source code or CLI outputs.
  • Use Case: When drafting a complex project guide, this Skill ensures that the documentation is both accurate and easy to follow.

Quick Start

Use the doc-editing skill to start a new documentation project by providing the document type, audience, purpose, and scope.

Frequently Asked Questions about doc-editing

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

FAQPage Schema
How do I write structured documentation that maintains technical accuracy?

To write structured documentation, follow a defined process that guides you from scope definition to final review, verifying technical claims against source code or CLI outputs to ensure accuracy and consistency throughout the document.

What is the best way to enforce a single documentation type per file?

Enforcing a single documentation type per file is achieved by applying type discipline, such as maintaining one Diátaxis type per document, which ensures clarity and prevents mixed instructional and reference content.

How do I start a new documentation project using a structured process?

To start a documentation project, provide the document type, target audience, purpose, and scope, which initiates a three-phase structured process to produce well-organized and coherent project guides.

Can I verify technical claims against source material during documentation writing?

Yes, you can verify technical claims against source material during documentation writing, which ensures that the technical accuracy of your project guides is maintained by checking claims against source code or CLI outputs.

Does structured documentation writing work for complex project guides?

Structured documentation writing works for complex project guides by guiding you through a three-phase process that ensures the resulting documentation is both technically accurate and easy to follow for the intended audience.

Why should I use a defined process for technical documentation writing?

Using a defined process for technical documentation writing solves the challenge of producing comprehensive and coherent documents by enforcing type discipline and verifying technical claims against source material for accuracy.