create-adr SKILL.md skillA
create-adr from tech-leads-club/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add tech-leads-club/agent-skills/create-adr@v1.0.0Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- tech-leads-club/agent-skills
- Path
packages/skills-catalog/skills/(creation)/create-adr/SKILL.md- Versions recorded
- 2
- Latest version
- v1.0.0, committed Mar 11, 2026
- First version recorded
- Mar 11, 2026
- Size
- 13,991 bytes
- Repository stars
- 7,124
- License
- a license file GitHub does not identify
Creates Architecture Decision Records (ADRs) to document significant architectural choices and their rationale for future team members. Use when the user says "write an ADR", "document this decision", "record why we chose X", "add an architecture decision record", "create an ADR for", or wants to capture the reasoning behind a technical choice so the team understands it later. Do NOT use when the decision hasn't been made yet (use create-rfc instead), for implementation planning…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# ADR Creator You are an expert in creating Architecture Decision Records (ADRs) — concise, durable documents that capture the context, decision, and consequences of significant architectural choices so future team members understand *why* things are the way they are. ## When to Use This Skill Use this skill when: - User asks to "write an ADR", "create an ADR", "add an architecture decision record" - User wants to "document why we chose X", "record this decision", "capture this architectural choice" - A significant technical decision has been made (or is being finalized) and needs to be recorded - The team wants to preserve the reasoning behind a choice for future engineers - User asks "why did we choose X" and the answer should be written down permanently Do NOT use for: - Decisions not yet made — use `create-rfc` to drive the decision process first - Implementation planning after the decision — use `technical-design-doc-creator` - Simple configuration choices or trivial code decisions - Meeting notes or general documentation ## ADR vs RFC — Critical Distinction | Aspect | ADR | RFC | |--------|-----|-----| …
Read the whole file at its exact version.
How to install
mdr add tech-leads-club/agent-skills/create-adr@sha256:cde8b63afba27bcbThe line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_qtystdvxji4nbl4d)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, all committed on Mar 11, 2026.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0.0 latest | 2026-03-11 | 5a9dfc0 | 13,991 B | A | view · diff |
| v1.0.0 | 2026-03-11 | e5d6c44 | 13,993 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (13991 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
tech-leads-club/agent-skills · 7,124 stars · license a license file GitHub does not identify · pushed 2026-11-02 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_qtystdvxji4nbl4d GET https://markdownregistry.com/api/v1/resolve?ref=tech-leads-club/agent-skills/create-adr GET https://markdownregistry.com/api/v1/blob/cde8b63afba27bcbbe22e46de64ed63287314233c331420bc33f50abdde06d1a
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from tech-leads-club/agent-skills
Every file in tech-leads-club/agent-skills