← All skills

design-docs

95 / 100 · Low risk

Fine to try.

By desplega-ai/ai-toolbox (GitHub) · design · 38 stars · scanned at commit 81611ca

Create and maintain living per-system design docs at thoughts/*/design-docs/<system-slug>.md — Purpose, Glossary, numbered testable Invariants (normative for the code-reviewing Spec axis), Boundaries & Non-goals, Interfaces, Decision log, Amendment log. Use when the user says "create a design doc", "write down the invariants", "document the design/contract of X", or when researching/planning/one-shot finds a design doc for the touched system and needs the read-and-abide rules.

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/'design-docs' ] || [ -L ~/.agents/skills/'design-docs' ]; then echo 'A skill folder named design-docs already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/desplega-ai/ai-toolbox' "$d" && git -C "$d" checkout --quiet '81611ca2de69dfd0bd57a49a4b34b74223f14944' -- 'cc-plugin/base/skills/design-docs' && mkdir -p ~/.agents/skills && cp -R "$d"/'cc-plugin/base/skills/design-docs' ~/.agents/skills/'design-docs' && 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/'design-docs' ~/.claude/skills/'design-docs' (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 desplega-ai/ai-toolbox shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/desplega-ai/ai-toolbox.svg)](https://zalavijaysinh.github.io/skilltrust/repos/desplega-ai/ai-toolbox/)

Score history