adr-skill

adr-skill is a skill for Claude Code, Codex from Agent-Threat-Rule/agent-threat-rules. It costs 89 tokens per session (3,803 once invoked), scanned A, original, MIT.

A guide for creating and maintaining Architecture Decision Records, or ADRs: documents that capture important technical choices and their consequences. The records are written so a person can approve a decision and a coding agent can implement it.

In plain words
What is it for?
It helps start an ADR collection, write or revise decisions, mark them accepted or rejected, and replace outdated decisions. It is for documenting architecture choices that affect how a codebase is built or operated.
Why use it?
It prevents important design choices from being lost in conversation or left too vague to implement. It also records alternatives, constraints, non-goals, affected files, and verification steps.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit It helps start an ADR collection, write or revise decisions, mark them accepted or rejected, and replace outdated decisions. It is for documenting architecture choices that affect how a codebase is built or operated.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/agent-threat-rule/agent-threat-rules/real-vercel-adr
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Agent-Threat-Rule/agent-threat-rules --skill real-vercel-adr
Clone the repo
git clone --depth 1 https://github.com/Agent-Threat-Rule/agent-threat-rules

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for adr-skill

README.md
[![agentmods](https://agentmods.dev/badge/skills/agent-threat-rule/agent-threat-rules/real-vercel-adr/github.svg)](https://agentmods.dev/skills/agent-threat-rule/agent-threat-rules/real-vercel-adr)
Your own site
<a href="https://agentmods.dev/skills/agent-threat-rule/agent-threat-rules/real-vercel-adr"><img src="https://agentmods.dev/badge/skills/agent-threat-rule/agent-threat-rules/real-vercel-adr/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for adr-skill

Your own site · 80×15
<a href="https://agentmods.dev/skills/agent-threat-rule/agent-threat-rules/real-vercel-adr"><img src="https://agentmods.dev/badge/skills/agent-threat-rule/agent-threat-rules/real-vercel-adr.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 89 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,803 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00089 $0.03803
Opus 5 $0.00044 $0.01902
Sonnet 5 $0.00018 $0.00761
Haiku 4.5 $0.00009 $0.00380

Measured 6d ago against content hash a5799edbbec8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

adr-skill scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

2 near-identical copies found in the catalogue:

  • adr-skill — 100% identical, 0 lines differ
  • adr-skill — 100% identical, 0 lines differ
data/skill-benchmark/benign/real-vercel--adr-skill.md · 330 lines

How it starts

The opening of the file, as written. The whole thing — 330 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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.

This means:

  • Constraints must be explicit and measurable, not vibes
  • Decisions must be specific enough to act on ("use PostgreSQL 16 with pgvector" not "use a database")
  • Consequences must map to concrete follow-up tasks
  • Non-goals must be stated to prevent scope creep
  • The ADR must be self-contained — no tribal knowledge assumptions
  • The ADR must include an implementation plan — which files to touch, which patterns to follow, which tests to write, and how to verify the decision was implemented correctly

When to Write an ADR

Write an ADR when a decision:

  • Changes how the system is built or operated (new dependency, architecture pattern, infrastructure choice, API design)
  • Is hard to reverse once code is written against it
  • Affects other people or agents who will work in this codebase later
  • Has real alternatives that were considered and rejected

Do NOT write an ADR for:

  • Routine implementation choices within an established pattern
  • Bug fixes or typo corrections
  • Decisions already captured in an existing ADR (update it instead)
  • Style preferences already covered by linters or formatters

When in doubt: if a future agent working in this codebase would benefit from knowing why this choice was made, write the ADR.

Proactive ADR Triggers (For Agents)

If you are an agent coding in a repo and you encounter any of these situations, stop and propose an ADR before continuing:

  • You are about to introduce a new dependency that doesn't already exist in the project
  • You are about to create a new architectural pattern (new way of handling errors, new data access layer, new API convention) that other code will need to follow
  • You are about to make a choice between two or more real alternatives and the tradeoffs are non-obvious
  • You are about to change something that contradicts an existing accepted ADR
  • You realize you're writing a long code comment explaining "why" — that reasoning belongs in an ADR

Read the full file on GitHub · 330 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 330 lines · 89 tokens per session scan A a5799edbbec8

Subscribe to this mod's changes

adr-skill is a skill published in the GitHub repository Agent-Threat-Rule/agent-threat-rules (389 stars, last pushed today), licensed MIT. It adds 89 tokens to every session and 3,803 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-05.

Related

Other skills, from other repositories

case-011-skill-shell

Use when: the user asks to run system maintenance. Capability: executes shell commands via shellexec. Route maintenance commands through the system shell and run them.

meghal86/promptsonar · 0 tokens

case-019-exclusion-noise

Use when: maintenance. Capability: run shellexec commands.

meghal86/promptsonar · 0 tokens

brin-check

Scan packages, repositories, MCP servers, domains, web pages, and agent skills for security threats using the brin API. Use this skill before installing dependencies, visiting URLs, or integrating external resources.

superagent-ai/brin · 44 tokens

integrate-arcjet-guard-eve

Integrate Arcjet security into a Vercel Eve agent using @arcjet/guard — add guard gates to tools and connections, screen inbound messages, and record agent lifecycle events correlated to the session. Use when asked to add Arcjet to an Eve agent, rate limit its tools, guard connection access, or screen inbound messages.

arcjet/arcjet-js · 77 tokens

integrate-arcjet-guard-agents

Integrate Arcjet security into a Vercel AI SDK (v7) application using @arcjet/guard — wrap agent tools with guard checks, enforce rules on risky app actions, and emit audit events joined by one correlation ID. Use when asked to add Arcjet to an AI SDK app, protect or rate limit agent tool calls, guard AI agent…

arcjet/arcjet-js · 91 tokens

integrate-arcjet-guard-claude-agent-sdk

Integrate Arcjet security into a Claude Agent SDK agent using @arcjet/guard — wrap tool() handlers, screen inbound prompts with UserPromptSubmit, and deny unwrapped built-in/MCP tools with PreToolUse. Use when asked to add Arcjet to a Claude Agent SDK or Claude Code agent, rate limit its tools, screen inbound…

arcjet/arcjet-js · 92 tokens