← All skills

adr-skill

95 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By vercel/ai (GitHub) · coding · 27,911 stars · scanned at commit 8bc7652

Create and maintain Architecture Decision Records (ADRs) optimized for agentic coding workflows. Use when you need to propose, write, update, accept/reject, deprecate, or supersede an ADR; bootstrap an adr folder and index; consult existing ADRs before implementing changes; or enforce ADR conventions. This skill uses Socratic questioning to capture intent before drafting, and validates output against an agent-readiness checklist.

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

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

Score history