← All skills

pdes-design-rationale-doc

100 / 100 · Low risk

Fine to try.

By polar-bear-org/claude-skills (GitHub) · design · 54 stars · scanned at commit 95f0180

Writes a Design Rationale Doc with the decision in one line, the options considered and why each lost, the principles applied, every claim linked to real evidence or marked as a gap, the trade-offs accepted, two or three pre-mortem risks and the signal that would reopen it. Use for "run pdes-design-rationale-doc", "write up why we chose this design", "why is it like this", "I keep explaining the design again", "design rationale", "document this design decision", "it felt right is not an answer"…

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Install

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

if [ -e ~/.agents/skills/'pdes-design-rationale-doc' ] || [ -L ~/.agents/skills/'pdes-design-rationale-doc' ]; then echo 'A skill folder named pdes-design-rationale-doc already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/polar-bear-org/claude-skills' "$d" && git -C "$d" checkout --quiet '95f01806ca43f6ee788d0579743e35853b695930' -- 'packs/product-designers-pack/skills/pdes-design-rationale-doc' && mkdir -p ~/.agents/skills && cp -R "$d"/'packs/product-designers-pack/skills/pdes-design-rationale-doc' ~/.agents/skills/'pdes-design-rationale-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/'pdes-design-rationale-doc' ~/.claude/skills/'pdes-design-rationale-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 polar-bear-org/claude-skills shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/polar-bear-org/claude-skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/polar-bear-org/claude-skills/)

Score history