# adr-skill

> Claude/Codex skill by [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md) · 27k stars · Updated 2026-09-17

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.

Tags: anthropic, artificial-intelligence, gemini, generative-ai, generative-ui, javascript, language-model, llm, nextjs, openai, react, svelte, typescript, vercel, vue

## Install

```sh
git clone https://github.com/vercel/ai /tmp/ai && ln -s /tmp/ai/skills/adr-skill ~/.claude/skills/adr-skill
```

## From README

ADR Skill Philosophy ADRs created with this skill are executable specifications for coding agents. A human approves the decision; an agent implements it. The ADR must contain everything the agent needs to write correct code without asking follow-up questions.

## Links

- HTML page: https://omgskills.com/skills/vercel-labs/ai/adr-skill/
- GitHub: https://github.com/vercel/ai
- Author: [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md)

## More from this repo

- [add-provider-package](https://omgskills.com/skills/vercel-labs/ai/add-provider-package/index.md) — Guide for adding first-party AI provider packages to the AI SDK.
   - [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md) · 27k stars

## More skills by this author

- [agent-browser](https://omgskills.com/skills/vercel-labs/agent-browser/agent-browser/index.md) — Browser automation CLI for AI agents.
   - [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md) · 43k stars
- [agentcore](https://omgskills.com/skills/vercel-labs/agent-browser/agentcore/index.md) — Used to run agent-browser on AWS Bedrock AgentCore cloud browsers.
   - [@vercel-labs](https://omgskills.com/library/vercel-labs/index.md) · 43k stars