Technical Writing

Generate technical documentation for Git commits, GitHub issues, PRDs, and specs.

8|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/caidanw/skills --skill technical-writing-caidanw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Technical Writing
Source: https://github.com/caidanw/skills/tree/main/tech-writing
Command: npx skills add https://github.com/caidanw/skills --skill technical-writing-caidanw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you write clear, concise, and effective technical documentation for various formats, ensuring your message is understood by both humans and machines.

Core Features & Use Cases

  • Structured Documentation: Provides templates and guidelines for Git commits, GitHub issues, PRDs, technical specs, and inline comments.
  • Clarity and Conciseness: Emphasizes core principles like leading with the point, using active voice, and eliminating filler words.
  • Use Case: When writing a commit message, use the provided format and principles to ensure it's informative and follows best practices.

Quick Start

Use the technical writing skill to draft a GitHub issue for a bug report.

Frequently Asked Questions about Technical Writing

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

FAQPage Schema
How do I write clear and concise technical documentation for a GitHub issue?

To write clear technical documentation for a GitHub issue, use structured templates that emphasize leading with the point, active voice, and eliminating filler words to ensure human and machine readability. This approach ensures your bug reports are informative and follow best practices.

What is the best way to format Git commit messages for machine readability?

The best way to format Git commit messages is to apply core writing principles like conciseness and active voice alongside specific formatting rules. This ensures your commits are informative, clear, and easily parsed by both humans and automated tools.

Does this technical writing tool support drafting PRDs and technical specifications?

Yes, this technical writing tool supports drafting PRDs and technical specifications. It generates effective documentation across multiple formats by adhering to specific content guidelines and principles of clarity for each document type.

How do I write inline code comments that follow technical writing best practices?

To write inline code comments following technical writing best practices, adhere to principles of conciseness and active voice. Apply the provided formatting rules and content guidelines to ensure your comments are clear and effective.

When should I use structured templates for technical documentation?

You should use structured templates for technical documentation whenever you need to write Git commits, GitHub issues, PRDs, or technical specs. They provide specific formatting rules and content guidelines that solve clarity issues and improve readability.