davidondrejInstall Adr Verbatim
Pick your agent. Every command is ready to paste.
npx skills add davidondrej/skills --skill adr-verbatimThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads adr-verbatim when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the adr-verbatim skill”. In Codex, type $adr-verbatim.
ADR Verbatim
Preserve the user's meaning, not the conversation transcript. Record only the decision and context needed to understand it.
Steps
- Extract the decision the user stated or approved in the conversation. Ask only if the decision is unclear; do not require them to dictate polished wording.
- Use the project's established ADR location, including a previously specified repository. Do not assume the current checkout owns the ADRs. Name the file by that directory's rule (check its README or AGENTS.md); if it has none, take the next number.
- Write a short, clear ADR. Remove filler, emotional reactions, repetition, rhetorical questions, and instructions to the agent. Fix grammar and clarify references without changing the meaning, scope, conditions, or priorities.
- Check every statement against the user's decision. Remove invented requirements and unapproved agent suggestions.
- Show the saved path and full ADR in a code block.
Format
Match the directory's filenames, such as docs/adr/0042-short-slug.md or docs/adr/20261030-175900-short-slug.md. Use the file's ID in the heading.
# <ID> — short title
Status: accepted (<user>, YYYY-MM-DD)
<The decision in plain English.>
Rules
- Prefer a short paragraph or list. Add sections only when they improve clarity.
- Do not add speculative rationale, alternatives, consequences, or implementation details.
- Use exact wording only when the user explicitly asks for an exact quote or verbatim passage.
- Newer decisions win. The user's latest decision overrides older ADRs, because they have more information and context now. Don't treat an older ADR as a blocker; record the new decision and name the ADR it supersedes.
- A changed decision needs a new ADR. Correct an existing ADR when the user explicitly requests it, without changing unrelated history.
Tips for Adr Verbatim
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Adr Verbatim
What does the Adr Verbatim skill do?
Record concise ADRs that preserve the user's decisions without conversational noise. Use for "adr-verbatim", "new ADR", "document that as an ADR", "record this decision", or supplied ADR wording.
How do I install Adr Verbatim?
Run "npx skills add davidondrej/skills --skill adr-verbatim" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Adr Verbatim work in Cursor and Codex?
Yes. Adr Verbatim uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Adr Verbatim free?
Adr Verbatim is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Adr Verbatim?
Adr Verbatim is published by davidondrej in the davidondrej/skills repository, together with 29 other skills.
