tech-writer

Generate Markdown developer documentation for READMEs, API docs, ADRs, and changelogs.

Updated Sep 9, 2025
One-click install
npx skills add https://github.com/htafolla/chrono-warp-drive --skill tech-writer-htafolla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-writer
Source: https://github.com/htafolla/chrono-warp-drive/tree/main/.opencode/skills/tech-writer
Command: npx skills add https://github.com/htafolla/chrono-warp-drive --skill tech-writer-htafolla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams keep documentation accurate and developer-friendly by producing consistent API docs, READMEs, ADRs, and changelogs as the codebase evolves.

Core Features & Use Cases

  • API Documentation: Writes endpoint-level guidance including auth, errors, examples, and usage constraints so developers can implement integrations quickly.
  • README and Developer Experience Docs: Produces quick starts, prerequisites, usage sections, and link/badge-friendly summaries that reduce time-to-first-success.
  • Architecture and Decision Records (ADRs): Documents context, options considered, rationale, and consequences to preserve engineering intent and support future maintenance.
  • Documentation as Code: Generates Markdown documentation designed to live alongside the codebase, align with code annotations, and be reviewed in PRs.

Quick Start

Ask the AI to write a developer README for your project that includes prerequisites, a 3-5 step quick start, one working usage example, and a short section linking to the main architecture documentation.

Frequently Asked Questions about tech-writer

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

FAQPage Schema
How do I generate API documentation from code changes in Markdown?

Generating API documentation from code changes creates consistent Markdown with endpoint-level guidance, auth details, error examples, and usage constraints. This keeps developer docs synchronized with codebase updates to reduce integration friction.

What is documentation as code and how does it keep READMEs updated?

Documentation as code maintains READMEs and developer docs as Markdown files living alongside the codebase. It aligns content with code annotations and supports reviewable PR updates, ensuring quick starts and prerequisites stay accurate.

How do I write an Architecture Decision Record that captures engineering context?

Writing an Architecture Decision Record captures engineering context by documenting options considered, rationale, and consequences. This preserves engineering intent and supports future maintenance by recording specific architectural choices.

Does documentation as code work with frontmatter-based repository conventions?

Documentation as code works with frontmatter-based repository conventions by producing Markdown content that follows existing repository standards. It applies active voice and includes code examples to support maintainable, reviewable documentation updates.

What's the best way to write a developer README that reduces onboarding friction?

Writing a developer README that reduces onboarding friction involves creating quick starts, prerequisites, usage sections, and link-friendly summaries. This approach decreases time-to-first-success by providing clear, active-voice Markdown guidance.