decision-first-technical-writing SKILL.md skillA
decision-first-technical-writing from adonis0123/adonis-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add adonis0123/adonis-skills/decision-first-technical-writing@v1.1.1Pins v1.1.1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- adonis0123/adonis-skills
- Path
skills/decision-first-technical-writing/SKILL.md- Versions recorded
- 3
- Latest version
- v1.1.1, committed Sep 14, 2026
- First version recorded
- Aug 22, 2026
- Size
- 5,496 bytes
- Repository stars
- 4
- License
- MIT
Create, rewrite, or review internal technical design documents after decisions are settled or while proposals and open questions are explicitly labeled. Use for design docs, architecture proposals, module designs, API or schema designs, and decision records. Route unresolved named-option convergence to grilling (workflow-gate Challenge in convergence mode) and ready-spec task breakdown to writing-plans. Do not use for tutorials, marketing copy, or code-only implementation plans.
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
# Decision-First Technical Writing Write technical design documents for two reading passes: a reviewer should understand the decisions and boundaries quickly, while an implementer should be able to continue into exact behavior and contracts. ## Route before writing - If the main task is choosing among named options, route to `grilling` (workflow-gate Challenge in convergence mode). Do not turn an unresolved shortlist into a final design decision. - If a ready specification or settled requirement needs file-level tasks, implementation steps, or a test plan, route to `writing-plans`. Do not maintain a second planning format here. - Otherwise continue only when the output is a technical design document and every uncertain statement can remain explicitly labeled `Proposal` or `Open question`. ## Establish the document contract Infer the audience, settled decision, and scope from the request and available evidence. Ask only when a user-owned fact would materially change the document. Route unresolved option choice as above instead of hiding it inside the document-writing pass. Before writing: …
Read the whole file at its exact version.
How to install
mdr add adonis0123/adonis-skills/decision-first-technical-writing@sha256:480599f094d9df43The line at the top of this page pins the label v1.1.1, 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_ozyua7rvb2x5vakl)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Aug 22, 2026 and Sep 14, 2026, about one every 12 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.1.1 latest | 2026-09-14 | f23223f | 5,496 B | A | view · diff |
| v1.1.0 | 2026-09-01 | 0590e3c | 4,463 B | A | view · diff |
| v1.0.0 | 2026-08-22 | 1957cd6 | 3,690 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 (5496 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
adonis0123/adonis-skills · 4 stars · license MIT · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ozyua7rvb2x5vakl GET https://markdownregistry.com/api/v1/resolve?ref=adonis0123/adonis-skills/decision-first-technical-writing GET https://markdownregistry.com/api/v1/blob/480599f094d9df43502e62a201200e0a7324263479f93aa14525f4df54492790
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.