adr-documentation

65 / 100 · Review before installing

Check before installing.

By MadAppGang/claude-code (GitHub) · writing · 288 stars · scanned at commit 6097ad4

Architecture Decision Records (ADR) documentation practice. Use when documenting architectural decisions, recording technical trade-offs, creating decision logs, or establishing architectural patterns. Trigger keywords - "ADR", "architecture decision", "decision record", "trade-offs", "architectural decision", "decision log".

Works with any agent that supports SKILL.md skills.

What this skill can do

Connects to the internet

The author does not mention this.

Found in 5 places.

plugins/dev/agents/devops.md, line 601. WebSearch: "{technology} {task} best practices 2026"
plugins/dev/agents/devops.md, line 612. WebSearch: "{technology} official documentation {specific feature}"
plugins/dev/agents/devops.md, line 623. WebSearch: "{technology} {task} example"

Show 2 more

plugins/dev/commands/feature.md, line 1063if curl -s ${test_url} > /dev/null 2>&1; then
plugins/dev/commands/implement.md, line 542if curl -s ${testUrl} > /dev/null 2>&1; then

Downloads and installs other software

The author does not mention this.

Found in 11 places.

plugins/dev/agents/doc-fixer.md, line 318npx my-tool init
plugins/dev/agents/doc-fixer.md, line 319npx my-tool migrate
plugins/dev/agents/doc-fixer.md, line 343npx my-tool

Show 8 more

plugins/dev/agents/ui-engineer.md, line 319elif npx claudish --list-accounts 2>/dev/null | grep -q "gemini"; then
plugins/dev/agents/ui-engineer.md, line 333npx claudish --model "$GEMINI_MODEL" --image "$SCREENSHOT_PATH" --quiet --auto-approve <<< "
plugins/dev/agents/ui-engineer.md, line 347npx claudish --model "$GEMINI_MODEL" \
plugins/dev/agents/ui-engineer.md, line 360npx claudish --model "$GEMINI_MODEL" --image "$NEW_SCREENSHOT_PATH" --quiet --auto-approve <<< "
plugins/dev/agents/ui.md, line 339- Verify Claudish is available: `npx claudish --version`
plugins/dev/agents/ui.md, line 363npx claudish --model "$GEMINI_MODEL" \
plugins/dev/commands/help.md, line 187- **Claudish CLI** (`npm install -g claudish`) - External AI model reviews
plugins/dev/commands/ui.md, line 358npx claudish --version 2>/dev/null || echo "Claudish not found"

Changes files outside its own folder

The author does not mention this.

Found in 2 places.

plugins/dev/agents/doc-fixer.md, line 346mkdir ~/.npm-global
plugins/dev/commands/worktree.md, line 134- Remove statusline worktree marker: `rm -f ~/.claude/.statusline-worktree-*`

Runs commands on your computer

The author does not mention this. It runs automatically when the plugin is installed.

Found in 6 places.

plugins/dev/.mcp.json, line 3"command": "claudish",
plugins/dev/hooks/feature-enforcement.json, line 43"command": "node ${CLAUDE_PLUGIN_ROOT}/plugins/dev/scripts/outer-loop-enforcer.js start-iteration ${SESSION_PATH}",
plugins/dev/hooks/feature-enforcement.json, line 49"command": "node ${CLAUDE_PLUGIN_ROOT}/plugins/dev/scripts/outer-loop-enforcer.js record-result ${SESSION_PATH} <PASS|FAIL|PARTIAL> [reason] [score]",

Show 3 more

plugins/dev/hooks/feature-enforcement.json, line 55"command": "node ${CLAUDE_PLUGIN_ROOT}/plugins/dev/scripts/outer-loop-enforcer.js check-can-complete ${SESSION_PATH}",
plugins/dev/hooks/feature-enforcement.json, line 61"command": "node ${CLAUDE_PLUGIN_ROOT}/plugins/dev/scripts/validation-criteria-enforcer.js ${SESSION_PATH}",
plugins/dev/hooks/feature-enforcement.json, line 67"command": "${CLAUDE_PLUGIN_ROOT}/plugins/dev/scripts/checkpoint-verifier.sh <phase> ${SESSION_PATH}",

Safer alternatives

Low-risk skills in the same category (writing) that look related. Check that one does what you need.

Install

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

if [ -e ~/.agents/skills/'adr-documentation' ] || [ -L ~/.agents/skills/'adr-documentation' ]; then echo 'A skill folder named adr-documentation already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/MadAppGang/claude-code' "$d" && git -C "$d" checkout --quiet '6097ad4643f23b7645a9c99c329887b623b32e57' -- 'plugins/dev/skills/adr-documentation' && mkdir -p ~/.agents/skills && cp -R "$d"/'plugins/dev/skills/adr-documentation' ~/.agents/skills/'adr-documentation' && 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/'adr-documentation' ~/.claude/skills/'adr-documentation' (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 MadAppGang/claude-code shows the score of its lowest-scoring skill.

SkillTrust badge for MadAppGang/claude-code

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/MadAppGang/claude-code.svg)](https://zalavijaysinh.github.io/skilltrust/repos/MadAppGang/claude-code/)

Score history

Date	Version	Score
2026-11-12	`6097ad4`	65