← All skills

pr-design-doc

95 / 100 · Low risk

Fine to try.

By OpenHands/software-agent-sdk (GitHub) · design · 1,380 stars · scanned at commit 7c97e26

For a non-trivial pull request, write a self-contained HTML design doc under the temporary `.pr/` directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the proposal at a glance - code/API design, and the before/after of the change, grounded to real code. Use when opening or updating a non-trivial PR, or when the user says "add a design doc", "document this PR for reviewers", "show the before/after", "make the design reviewable", or "write the .pr/ page".

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'pr-design-doc' ] || [ -L ~/.agents/skills/'pr-design-doc' ]; then echo 'A skill folder named pr-design-doc already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/OpenHands/software-agent-sdk' "$d" && git -C "$d" checkout --quiet '7c97e26f3e4a04edf1c247680d8dca57007885ae' -- '.agents/skills/pr-design-doc' && mkdir -p ~/.agents/skills && cp -R "$d"/'.agents/skills/pr-design-doc' ~/.agents/skills/'pr-design-doc' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'pr-design-doc' ~/.claude/skills/'pr-design-doc' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for OpenHands/software-agent-sdk shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/OpenHands/software-agent-sdk.svg)](https://zalavijaysinh.github.io/skilltrust/repos/OpenHands/software-agent-sdk/)

Score history