writing-technical-docs

Draft and iteratively review RFCs, proposals, and architecture designs.

8|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/lemieux/rfc-skills --skill writing-technical-docs-lemieux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-technical-docs
Source: https://github.com/lemieux/rfc-skills/tree/main/skills/writing-technical-docs
Command: npx skills add https://github.com/lemieux/rfc-skills --skill writing-technical-docs-lemieux

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the creation and refinement of technical documents like RFCs, proposals, and design docs, ensuring clarity, consistency, and adherence to best practices.

Core Features & Use Cases

  • Drafting: Generates RFCs from source material, following a defined style guide.
  • Review & Revision: Iteratively reviews drafts using a dedicated sub-agent, identifying and fixing issues.
  • Document Type Guidance: Helps select the appropriate document type (PRD, RFC, Implementation Plan).
  • Use Case: You need to draft a new RFC for a system architecture change. This Skill will guide you through the process, help write the initial draft, and then iterate on it based on automated reviews.

Quick Start

Use the writing-technical-docs skill to draft an RFC from the document located at '/path/to/source/material.md'.

Frequently Asked Questions about writing-technical-docs

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

FAQPage Schema
How do I draft an RFC from existing source material?

To draft an RFC from source material, the Skill guides you through selecting the appropriate document type and generating an initial draft that adheres to a defined style guide and structural rules. It reads your source files to produce the RFC draft.

What is the best way to review and refine an architecture design document?

The best way to review an architecture design document is using the Skill's iterative review loops with dedicated sub-agents. This process identifies clarity, consistency, and tone issues, then automatically refines the draft to ensure professional quality.

When do I need a PRD versus an RFC or Implementation Plan?

You need a PRD, RFC, or Implementation Plan depending on your project's stage and goals. The Skill provides document type guidance to help you select the correct format, ensuring the structure matches the specific design or proposal requirements.

Can I enforce a specific writing style guide when generating technical proposals?

Yes, you can enforce a specific writing style guide when generating technical proposals. The Skill adheres to defined style guides and structural rules throughout the drafting and revision process to maintain consistency and clarity.

Does this technical writing process work without external dependencies?

Yes, the technical writing process works without external dependencies. The Skill operates independently using internal scripts and references to automate drafting, generate reviews, and apply style guides for your documents.