How do I install the Adr Gen skill?

Run npx skillmds@latest add modbender/adr-gen in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Adr Gen safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Adr Gen?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Adr Gen free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Adr Gen?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Adr Gen by modbender — Agent Skill

Name: Adr Gen
Rating: 4.5 (4 reviews)
Author: modbender

File contents

ADR Gen

"Why did we use Redis instead of Memcached?" Six months later, nobody remembers. This tool generates Architecture Decision Records from your context. Captures the decision, the alternatives considered, and the reasoning. Future you will thank present you.

One command. Zero config. Just works.

Quick Start

npx ai-adr "We chose PostgreSQL over MongoDB for our user data"

What It Does

Generates properly formatted ADR documents
Documents the context and problem being solved
Lists alternatives that were considered
Explains the decision and its reasoning
Notes consequences and trade-offs

Usage Examples

# Generate an ADR from a decision
npx ai-adr "Switching from REST to GraphQL for our public API"

# Include context about your constraints
npx ai-adr "Using Kafka for event streaming" --context "High throughput, multi-consumer"

# Output to your docs folder
npx ai-adr "Adopting TypeScript" --output docs/adr/001-typescript.md

Best Practices

Write ADRs when you make decisions - Not six months later when you forgot why
Include the alternatives - What else did you consider? Why didn't you pick those?
Be honest about trade-offs - Every decision has downsides. Document them.
Number your ADRs - 001-database-choice.md, 002-auth-provider.md, etc.

When to Use This

Making a significant technical decision
Onboarding new team members who ask "why did we..."
Preparing for architecture reviews
Building a knowledge base of your technical choices

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

GitHub: https://github.com/LXGIC-Studios
Twitter: https://x.com/lxgicstudios
Substack: https://lxgicstudios.substack.com
Website: https://lxgicstudios.com

Requirements

No install needed. Just run with npx. Node.js 18+ recommended.

npx ai-adr --help

How It Works

The tool takes your decision statement, researches common alternatives and trade-offs for that technology choice, then generates a structured ADR document following the standard format: Title, Status, Context, Decision, Consequences.

License

MIT. Free forever. Use it however you want.

Built by LXGIC Studios

GitHub: github.com/lxgicstudios/ai-adr
Twitter: @lxgicstudios

---name: adr-gendescription: Generate Architecture Decision Records with AI. Use when documenting technical decisions.--- # ADR Gen "Why did we use Redis instead of Memcached?" Six months later, nobody remembers. This tool generates Architecture Decision Records from your context. Captures the decision, the alternatives considered, and the reasoning. Future you will thank present you. **One command. Zero config. Just works.** ## Quick Start ```bash npx ai-adr "We chose PostgreSQL over MongoDB for our user data" ``` ## What It Does - Generates properly formatted ADR documents - Documents the context and problem being solved - Lists alternatives that were considered - Explains the decision and its reasoning - Notes consequences and trade-offs ## Usage Examples ```bash # Generate an ADR from a decision npx ai-adr "Switching from REST to GraphQL for our public API" # Include context about your constraints npx ai-adr "Using Kafka for event streaming" --context "High throughput, multi-consumer" # Output to your docs folder npx ai-adr "Adopting TypeScript" --output docs/adr/001-typescript.md ``` ## Best Practices - **Write ADRs when you make decisions** - Not six months later when you forgot why - **Include the alternatives** - What else did you consider? Why didn't you pick those? - **Be honest about trade-offs** - Every decision has downsides. Document them. - **Number your ADRs** - 001-database-choice.md, 002-auth-provider.md, etc. ## When to Use This - Making a significant technical decision - Onboarding new team members who ask "why did we..." - Preparing for architecture reviews - Building a knowledge base of your technical choices ## Part of the LXGIC Dev Toolkit This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work. **Find more:** - GitHub: https://github.com/LXGIC-Studios - Twitter: https://x.com/lxgicstudios - Substack: https://lxgicstudios.substack.com - Website: https://lxgicstudios.com ## Requirements No install needed. Just run with npx. Node.js 18+ recommended. ```bash npx ai-adr --help ``` ## How It Works The tool takes your decision statement, researches common alternatives and trade-offs for that technology choice, then generates a structured ADR document following the standard format: Title, Status, Context, Decision, Consequences. ## License MIT. Free forever. Use it however you want. --- **Built by LXGIC Studios** - GitHub: [github.com/lxgicstudios/ai-adr](https://github.com/lxgicstudios/ai-adr) - Twitter: [@lxgicstudios](https://x.com/lxgicstudios)

Frequently asked questions

Adr Gen