create-decision SKILL.md skillA
create-decision from tomzx/agents is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add tomzx/agents/create-decision@git:20261007.b35fc4bPins git:20261007.b35fc4b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- tomzx/agents
- Path
skills/create-decision/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261007.b35fc4b, committed Oct 7, 2026
- First version recorded
- Jul 26, 2026
- Size
- 3,868 bytes
- Repository stars
- 12
- License
- MIT
Record an architectural or implementation decision with context, alternatives considered, trade-offs, and consequences.
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
# Create Decision Records a decision made during implementation as a lightweight Architecture Decision Record (ADR). Captures the context, the decision, alternatives considered, trade-offs, and expected consequences so future contributors understand why the code is the way it is. ## Prerequisites - Apply the shared SDLC conventions in `skills/sdlc/references/shared.md`. - A concrete decision that was made (or needs to be made) during implementation - Enough context to explain the forces that shaped the decision ## Steps 1. Identify the decision: what question was answered or choice was made. 2. Describe the context: what problem exists, what constraints apply, what prompted the decision. 3. List the options that were considered (at least two, including the chosen one). 4. State the decision clearly. 5. Explain the trade-offs: what is gained and what is sacrificed. 6. Describe the consequences: what changes as a result, what follow-up is expected. 7. Save the document to `.sdlc/knowledge/decisions/` (or the project's existing ADR directory if one exists) using the filename pattern `N-<slug>.md` where `N` is the next available number (counting existing files in that directory). …
Read the whole file at its exact version.
How to install
mdr add tomzx/agents/create-decision@sha256:6ff818870dae41cdThe line at the top of this page pins the label git:20261007.b35fc4b, 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_gaxwzkhkyraxbgxh)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Jul 26, 2026 and Oct 7, 2026, about one every 18 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261007.b35fc4b latest | 2026-10-07 | b35fc4b | 3,868 B | A | view · diff |
| git:20261005.8154ecd | 2026-10-05 | 8154ecd | 3,868 B | A | view · diff |
| git:20260828.a0aec57 | 2026-08-28 | a0aec57 | 4,008 B | A | view · diff |
| git:20260827.1dfdffc | 2026-08-27 | 1dfdffc | 3,710 B | A | view · diff |
| git:20260726.2ef4527 | 2026-07-26 | 2ef4527 | 3,531 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 (3868 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
tomzx/agents · 12 stars · license MIT · pushed 2026-10-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_gaxwzkhkyraxbgxh GET https://markdownregistry.com/api/v1/resolve?ref=tomzx/agents/create-decision GET https://markdownregistry.com/api/v1/blob/6ff818870dae41cd69b3c98750fbee67a4d7401b65e77bc00b6803ad286638c3
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.