technical-writing

Create structured technical tutorials and developer documentation with code examples.

Updated Sep 6, 2018
One-click install
npx skills add https://github.com/terakoya76/terakoya76-playbooks --skill technical-writing-terakoya76
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-writing
Source: https://github.com/terakoya76/terakoya76-playbooks/tree/main/roles/dotfiles/files/claude/skills/technical-writing
Command: npx skills add https://github.com/terakoya76/terakoya76-playbooks --skill technical-writing-terakoya76

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, actionable framework for creating clear and thorough technical writing that developers can immediately apply.

Core Features & Use Cases

  • Clear writing guidelines for structure, tone, and audience.
  • Practical templates and checklists for tutorials, API references, and architecture docs.
  • Real-world examples that demonstrate end-to-end implementation and justification of design decisions.

Quick Start

Provide a comprehensive developer guide following a complete end-to-end example from setup to implementation.

Frequently Asked Questions about technical-writing

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

FAQPage Schema
How do I write developer tutorials with clear code examples?

Developer tutorials require structured content with defined sections, consistent tone, practical code examples, and concrete step-by-step procedures. This approach ensures complex concepts are communicated effectively for onboarding new engineers.

What is the best way to structure API reference documentation?

API reference documentation benefits from practical templates and checklists that maintain clear structure, tone, and audience alignment. Using real-world examples demonstrates end-to-end implementation and justifies design decisions.

How do I create software library guides for onboarding new engineers?

Software library guides for onboarding require clear writing guidelines that communicate complex concepts effectively. Providing comprehensive developer guides following a complete end-to-end example from setup to implementation accelerates knowledge transfer.

Does this technical writing approach work for platform guidance and maintenance docs?

Technical writing for platform guidance and maintenance applies structured content with defined sections and consistent tone. It supports knowledge transfer across API design, software libraries, and platform guidance for ongoing maintenance needs.

What should I include in architecture docs to justify design decisions?

Architecture docs should include real-world examples that demonstrate end-to-end implementation and justification of design decisions. Practical templates and checklists ensure clear structure, tone, and audience alignment throughout the documentation.

How do I ensure consistent tone across developer documentation?

Consistent tone across developer documentation is achieved through clear writing guidelines for structure, tone, and audience. Applying practical templates and checklists for tutorials and API references maintains consistency and clarity.