technical-docs

Define and enforce technical documentation standards across READMEs, API docs, user guides, and docstrings.

13|1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/danchamorro/pi-agent-toolkit --skill technical-docs-danchamorro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-docs
Source: https://github.com/danchamorro/pi-agent-toolkit/tree/main/dotfiles/global-skills/technical-docs
Command: npx skills add https://github.com/danchamorro/pi-agent-toolkit --skill technical-docs-danchamorro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes clear standards and best practices for creating and maintaining technical documentation across READMEs, API docs, user guides, and docstrings, reducing inconsistency and improving readability.

Core Features & Use Cases

  • Documentation workflow: structured planning, outlining, review, and approvals to ensure consistent documentation across projects.
  • Core writing standards: tone, structure, formatting, code example practices, and terminology guidelines.
  • API documentation guidance: requirements for parameters, returns, errors, cross-references, and sample docs.
  • Visual communication: guidelines for diagrams, tables, and examples, with references to pre-defined diagram and example repositories.
  • Quality checks: a comprehensive quality checklist used before finalizing documentation.

Quick Start

Follow the documented workflow and writing standards to create or update technical documents.

Frequently Asked Questions about technical-docs

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

FAQPage Schema
What writing standards should I follow for technical documentation like READMEs and API docs?

Technical documentation standards cover tone, structure, formatting, code example practices, and terminology guidelines to ensure consistency across READMEs, API docs, and user guides.

How do I structure a documentation workflow for creating new technical docs?

A structured documentation workflow involves planning, outlining, reviewing, and approving technical docs to maintain consistent quality across developer, product, and user audiences.

What should be included in API documentation parameters, returns, and errors?

API documentation requirements include detailing parameters, returns, errors, cross-references, and sample docs to provide comprehensive and clear API references.

How do I run quality checks on technical documentation before publishing?

Run a comprehensive quality checklist before finalizing technical documentation to verify that writing standards, visual conventions, and API requirements are met.

Are there visual conventions for diagrams and tables in user guides?

Visual communication guidelines define standards for diagrams, tables, and examples in user guides, often referencing pre-defined diagram and example repositories for consistency.

Does this documentation approach work for updating existing docstrings?

Yes, these documentation standards apply to both creating new docs and updating existing docstrings, READMEs, and API references across different project audiences.