Writing Design Docs Skill for ChatGPT: Clarify Settled Decisions and Open Checks
Edit a repository design document so reviewers see the chosen approach, rationale, and boundaries first. Consolidate unresolved checks and repeated explanations.
中文Install in ChatGPT
Requires a ChatGPT workspace where you can create skills. This is a text adaptation of the pinned GitHub source.
- Review the inputs and outputs in the pinned .claude/skills/writing-design-docs/SKILL.md.
- In ChatGPT, open Plugins, Skills, Create, and Create with editor.
- Use your pasted design draft and confirmed decisions to remove repetition, preserve evidence and keep unresolved questions visible.
- Save the skill and try the fictional example in a new chat.
Example task
A fictional draft explains filter rules twice and alternates between URL state and session storage. The team chose URL state and still needs to check browser back navigation. Rewrite the draft structure.What to check
Lead with the URL choice and scope. Keep session storage as an alternative with its decision reason, put browser back in verification, and retain one canonical filter explanation.
Original SKILL.md on GitHub · Updated
Frequently asked question
Should alternative designs be deleted from the draft?
Keep alternatives that explain the current decision. Move detailed exploration to an appendix or reference and let the main text communicate the chosen approach.