---
title: "Make Decision Doc - Air Market"
description: "A team makes a choice that is not obvious, and months later nobody remembers why. This adds a numbered decision document that captures the choice and the reasoning behind it. Reach for it when someon…"
canonical: "https://airmarket.ai/app/make-decision-doc"
---

[Air Market](/) / [Writing](/category/writing) / Make Decision Doc

Skill by [Remix](/@remix-run)

# Make Decision Doc

Write down why you picked this, before everyone forgets

## What this does

A team makes a choice that is not obvious, and months later nobody remembers why. This adds a numbered decision document that captures the choice and the reasoning behind it. Reach for it when someone asks for a decision doc, an ADR, or a written record of why one approach won over the alternatives.

### Top 3 things it does for you

- Record why we chose this approach over the others
- Write an ADR for a call we just made
- Capture the reasoning behind a non-obvious design choice

## Information

**Make Decision Doc at a glance**

|  |  |
| --- | --- |
| Kind | Skill |
| Publisher | [Remix](/@remix-run) |
| Category | [Writing](/category/writing) |
| Works with | Agent Skills - an open standard supported by 40+ agents |
| Size | 4 KB |
| Licence | _Not recorded_ |
| Repository | [remix-run/remix](https://github.com/remix-run/remix/tree/823e48cb9c8fff787a4d951a380ae42f1672e718/.agents/skills/make-decision-doc) |
| GitHub stars | 33,323 (as of Nov 2026) |
| Installs | 13, counted by skills.sh (Nov 2026) |

## Security report

**Verified.** AIR scanned this exact version of Make Decision Doc and flagged nothing. AIR's verdict: **safe**.

**What Make Decision Doc's check was run against**

|  |  |
| --- | --- |
| Commit | 823e48cb9c8fff787a4d951a380ae42f1672e718 |
| Content hash | 38af1187e268fc52481d37bfe43e07091911fe14ebb96c3695189e66d3465cc8 |
| Files read | [Browse the files at this exact commit](https://github.com/remix-run/remix/blob/823e48cb9c8fff787a4d951a380ae42f1672e718/.agents/skills/make-decision-doc/SKILL.md) |

A scan is named by the exact content it read, not by a version number. A different version is a different artifact, and nothing here applies to a version AIR has not scanned.

[Read the full security report for Make Decision Doc](/security/make-decision-doc)

## About Make Decision Doc

Some architectural choices are not obvious from the code that results from them. This adds a numbered decision document under `decisions/` to capture that kind of choice.

Use it when someone asks for a decision doc, an ADR, or design rationale, or wants a record of why one approach was picked over the alternatives.

## What's inside

- SKILL.md - instructions

## Questions

### Is Make Decision Doc safe to install?

AIR scanned this exact version of Make Decision Doc and flagged nothing. AIR's verdict: safe. The verdict is named by the content that was read, at commit 823e48cb9c8f, so it cannot drift onto a version nobody scanned. The full report is at https://airmarket.ai/security/make-decision-doc.

### How do I install Make Decision Doc?

Open https://airmarket.ai/app/make-decision-doc on Air Market and use the install action: Air Market hands Claude a prompt naming this exact skill, and Claude sets it up. Source, pinned to the exact commit this listing describes: https://github.com/remix-run/remix/tree/823e48cb9c8fff787a4d951a380ae42f1672e718/.agents/skills/make-decision-doc. Install from that link, not the branch.

## Related on Air Market

- [More Writing listings](/category/writing)
- [Everything by Remix](/@remix-run)

---

Canonical URL: <https://airmarket.ai/app/make-decision-doc>