📝 Decisions
Guide for recording significant architectural and design decisions in docs/decisions.md. Use this skill when clearly significant architectural decisions are made (database choices, frameworks, core design patterns) or when explicitly asked to document a decision. Be conservative - only suggest for m
npx playbooks add skill maragudk/skills --skill decisions
About Decisions
Guide for recording significant architectural and design decisions in docs/decisions.md. Use this skill when clearly significant architectural decisions are made (database choices, frameworks, core design patterns) or when explicitly asked to document a decision. Be conservative - only suggest for m
This compact 41-word instruction set is purpose-built for documentation work in AI coding agents. Install with a single command.
Use Cases
- Writing API references and README files
- Generating inline code comments and docstrings
- Creating architecture decision records (ADRs)
- Keeping docs in sync with code changes
Example Prompts
System Prompt (41 words)
Guide for recording significant architectural and design decisions in docs/decisions.md. Use this skill when clearly significant architectural decisions are made (database choices, frameworks, core design patterns) or when explicitly asked to document a decision. Be conservative - only suggest for m
Frequently Asked Questions
What is Decisions?
Decisions is a free documentation skill for AI coding agents. Guide for recording significant architectural and design decisions in docs/decisions.md. Use this skill when clearly significant architectural decisions are made (database choices, frameworks, core design patterns) or when explicitly asked to document a decision. Be conservative - only suggest for m. It provides a specialized system prompt that configures your agent with documentation expertise.
How do I use Decisions with Claude Code?
Run npx playbooks add skill maragudk/skills --skill decisions in your terminal to install Decisions into your Claude Code session. It works immediately after installation.
Which AI coding agents work with Decisions?
Decisions is compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any AI agent that supports custom system prompts or .cursorrules files.
Is Decisions free to use?
Yes, Decisions is completely free and open source. The full source is available on GitHub at https://github.com/maragudk/skills/tree/main/decisions. You only need a subscription to the AI agent you use it with.
