Documentation Strategy Skill for ChatGPT: Plan README, ADR, and Runbook Ownership
Design a documentation map around reader tasks. Assign owners, discoverable entry points, and maintenance triggers to project guides, architecture records, and runbooks.
中文Install in ChatGPT
Use an eligible ChatGPT workspace with permission to create skills and, for uploads, upload permission. The installation path for this text-only adaptation was checked against OpenAI documentation. Workspace runtime verification is pending.
- Download engineer/engineer-toolkit/skills/documentation-strategy/SKILL.md from the pinned GitHub source. Keep the name, description, and instructions for documentation-strategy together as a standalone text skill.
- In a ChatGPT workspace with skills and uploads enabled, open Plugins, Skills, Create, and Upload from your computer. Choose a skill package format accepted by the file picker. You can also choose Create with editor and enter the original name, description, and instructions.
- After the scan completes, check that documentation-strategy appears in Installed. Type @ in a new chat, select the skill, and use the fictional example on this page to check the output.
Example task
A fictional inventory app has a README, CSV field list, and a decision to change databases. Design entry points for new contributors and on-call staff and name update triggers for each document.What to check
The README links to setup and related docs. CSV field docs follow importer changes, the database decision gets an ADR, and the on-call entry leads to a runbook. Unknown owners are marked for assignment.
Original SKILL.md on GitHub · Updated
Frequently asked question
Where should decisions from a team conversation go?
For lasting decisions, record context, alternatives, choice, and consequences in an ADR. Link to it from the architecture notes.