documentation

Generate and maintain technical documentation for codebases, APIs, runbooks, and architecture artifacts.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/FoundationForge/cowork-plugins --skill documentation-foundationforge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation
Source: https://github.com/FoundationForge/cowork-plugins/tree/main/plugins/engineering/skills/documentation
Command: npx skills add https://github.com/FoundationForge/cowork-plugins --skill documentation-foundationforge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams frequently struggle with inconsistent, incomplete, or outdated technical documentation that slows onboarding, increases operational risk, and reduces developer productivity. This Skill helps produce concise, audience-focused docs that are easy to discover and keep current.

Core Features & Use Cases

  • README & Quick Start: Craft a focused README that explains purpose, provides a <5 minute quick start, and links to deeper resources.
  • API Documentation: Produce endpoint references with authentication, request/response examples, pagination, and SDK usage.
  • Runbooks & Oncall Procedures: Create step-by-step operational runbooks with prerequisites, rollback steps, and escalation paths.
  • Architecture & Onboarding Guides: Document high-level context, diagrams, key decisions, and developer onboarding tasks.
  • Use Case: When launching a new microservice, generate the README, API reference examples, an incident runbook, and a short onboarding checklist in one request.

Quick Start

Write a README and API reference for the "billing-service" that includes a one-paragraph purpose, a quick-start with curl examples, and a short runbook for common failures.

Frequently Asked Questions about documentation

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

FAQPage Schema
How do I generate API documentation with request and response examples?

Generate API documentation by producing endpoint references that include authentication details, request/response examples, pagination info, and SDK usage. This API documentation targets engineering teams and provides clear operational context for integration.

What is the best way to write a runbook for oncall procedures?

Write a runbook by creating step-by-step operational procedures with prerequisites, rollback steps, and escalation paths. A runbook ensures operations teams have clear instructions for handling common failures and incidents.

How do I create an onboarding guide for a new microservice?

Create an onboarding guide by documenting high-level architecture context, key decisions, and developer onboarding tasks. An onboarding guide accelerates team integration by providing targeted quick-starts and clear resource linking.

Can I use this to write a README with a quick start and curl examples?

Yes, you can craft a focused README that explains purpose, provides a under five minute quick start, and links to deeper resources. The README includes curl examples and short runbooks for common service failures.

What should technical documentation include for maintenance workflows?

Technical documentation for maintenance workflows should include decision rationale, rollback steps, and audience-targeted operational procedures. This ensures engineering, product, and operations teams can maintain and operate systems effectively.

Does this approach work for both architecture docs and API references?

Yes, this approach works for both architecture docs and API references by producing audience-focused content. It documents high-level context and decisions for architecture, alongside endpoint references and examples for API documentation.