New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Mcaf Adr Writing

by managedcode in managedcode/Storage

Create or update an ADR under docs/ADR/ for architectural decisions, dependency changes, data-model changes, or cross-cutting policy shifts.

MITAuto-check passedDevelopment

Install Mcaf Adr Writing

skills CLI
$ npx skills add managedcode/Storage --skill mcaf-adr-writing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install managedcode/Storage mcaf-adr-writing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/managedcode/Storage.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/mcaf-adr-writing .claude/skills/mcaf-adr-writing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mcaf-adr-writing
GitHub stars
138
Token cost
~951 tokens
SKILL.md length
441 words
Files
3 (incl. references)
Skills in repo
41
Repo updated
First seen
Licence
MIT

At a glance

Create or update an ADR under docs/ADR/ for architectural decisions, dependency changes, data-model changes, or cross-cutting policy shifts.

  • Works in 3 steps: Read the nearest AGENTS.md and confirm… → Run this skill's Workflow through the… → Return the Required Result Format with…
  • The user asks to write
  • SKILL.md covers Trigger On, Value, Do Not Use For and Inputs, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mcaf Adr Writing is an agent skill from managedcode/Storage. Create or update an ADR under docs/ADR/ for architectural decisions, dependency changes, data-model changes, or cross-cutting policy shifts. Use when the user asks to write, update, or document an ADR, record a design decision, capture architecture trade-offs, or justify a repo-wide technical policy.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/ADR-FORMATS.md` and `references/adr-template.md`). Compatibility notes: Requires repository write access; produces Markdown ADRs with Mermaid diagrams.

It sits in Development, covering Architecture decision records. The repository describes itself as: Storage library provides a universal interface for accessing and manipulating data in different cloud blob storage providers. The licence is MIT.

When your agent uses it

  • The user asks to write
  • Document an ADR
  • Record a design decision
  • Capture architecture trade-offs

Example prompts

  • “/mcaf-adr-writing”

Requirements

  • Compatibility (from SKILL.md): Requires repository write access; produces Markdown ADRs with Mermaid diagrams.

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Read the nearest AGENTS.md and confirm scope and constraints.
  2. Run this skill's Workflow through the Ralph Loop until outcomes are acceptable.
  3. Return the Required Result Format with concrete artifacts and verification evidence.

What it can do on your machine

Read from SKILL.md and the folder at commit 5d32121. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires repository write access; produces Markdown ADRs with Mermaid diagrams.

    From compatibility in the SKILL.md frontmatter.

Context cost

Mcaf Adr Writing loads about 951 tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 80 tokens; SKILL.md has 441 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~951
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from managedcode/Storage at commit 5d32121, republished under its MIT licence (© managedcode). 441 words, ~951 tokens.

Download SKILL.mdSave it as .claude/skills/mcaf-adr-writing/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
mcaf-adr-writing
description
Create or update an ADR under `docs/ADR/` for architectural decisions, dependency changes, data-model changes, or cross-cutting policy shifts. Use when the user asks to write, update, or document an ADR, record a design decision, capture architecture trade-offs, or justify a repo-wide technical policy.
compatibility
Requires repository write access; produces Markdown ADRs with Mermaid diagrams.

MCAF: ADR Writing

Trigger On

  • a dependency, boundary, platform, contract, or data model is changing
  • a design decision has meaningful trade-offs that should be recorded
  • a repo-wide engineering policy needs a durable rationale

Value

  • produce a concrete project delta: code, docs, config, tests, CI, or review artifact
  • reduce ambiguity through explicit planning, verification, and final validation skills
  • leave reusable project context so future tasks are faster and safer

Do Not Use For

  • feature-level behaviour details without an architecture decision
  • generic architecture overview content

Inputs

  • docs/Architecture.md
  • related feature docs
  • the nearest AGENTS.md
  • current constraints, options, and risks

Quick Start

  1. Read the nearest AGENTS.md and confirm scope and constraints.
  2. Run this skill's Workflow through the Ralph Loop until outcomes are acceptable.
  3. Return the Required Result Format with concrete artifacts and verification evidence.

Workflow

  1. Start from the concrete decision that must be made now.
  2. If the ADR is missing, scaffold it from references/adr-template.md.
  3. Record:
    • context and problem
    • chosen decision
    • alternatives considered
    • trade-offs and consequences
    • implementation plan
  4. Add diagrams only when they remove ambiguity.
  5. Link the ADR to affected feature docs and docs/Architecture.md.

Deliver

  • docs/ADR/ADR-XXXX-short-title.md
  • linked updates to architecture docs when the decision changes boundaries

Validate

  • the decision and rejected alternatives are explicit
  • trade-offs are concrete, not hand-wavy
  • implementation impact is clear
  • a future engineer can understand why this path was chosen
Show full SKILL.md (215 more words)Show less

Ralph Loop

Use the Ralph Loop for every task, including docs, architecture, testing, and tooling work.

  1. Plan first (mandatory):
    • analyze current state
    • define target outcome, constraints, and risks
    • write a detailed execution plan
    • list final validation skills to run at the end, with order and reason
  2. Execute one planned step and produce a concrete delta.
  3. Review the result and capture findings with actionable next fixes.
  4. Apply fixes in small batches and rerun the relevant checks or review steps.
  5. Update the plan after each iteration.
  6. Repeat until outcomes are acceptable or only explicit exceptions remain.
  7. If a dependency is missing, bootstrap it or return status: not_applicable with explicit reason and fallback path.
Required Result Format
  • status: complete | clean | improved | configured | not_applicable | blocked
  • plan: concise plan and current iteration step
  • actions_taken: concrete changes made
  • validation_skills: final skills run, or skipped with reasons
  • verification: commands, checks, or review evidence summary
  • remaining: top unresolved items or none

For setup-only requests with no execution, return status: configured and exact next commands.

Load References

  • start with references/adr-template.md
  • use references/ADR-FORMATS.md only for numbering or formatting conventions

Example Requests

  • "Write an ADR for moving to event-driven notifications."
  • "Document why we are adding PostgreSQL instead of keeping SQLite."
  • "Capture the policy decision behind local project AGENTS files."

© managedcode, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .codex/skills/mcaf-adr-writing of managedcode/Storage.

  • SKILL.md
  • references/ADR-FORMATS.md
  • references/adr-template.md

Open the folder on GitHubat commit 5d32121

Compare with similar skills

Mcaf Adr Writing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mcaf Adr Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mcaf Adr Writing this skillmanagedcode/Storage138—~951Automated safety check: PassMIT
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
Cto AdvisorIbrahim-3d/orchestrator-supaconductor3804 repos~2.4kAutomated safety check: PassMIT
Improve Codebase Architectureywwynm/EverythingDone14415 repos~1.3kAutomated safety check: PassGPL-3.0
Domain Modelingbrim-borium/spotify_sdk1665 repos~806Automated safety check: PassApache-2.0
Design Doc MermaidSpillwaveSolutions/design-doc-mermaid1751 repos~5.6kAutomated safety check: PassNone

Similar skills

  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed

  • Cto Advisor

    Ibrahim-3d/orchestrator-supaconductor

    Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

    380 GitHub starsUsed in 4 repos~2.4k tokens
    DevelopmentAuto-check passed

  • Improve Codebase Architecture

    ywwynm/EverythingDone

    Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.

    144 GitHub starsUsed in 15 repos~1.3k tokens
    DevelopmentAuto-check passed

  • Domain Modeling

    brim-borium/spotify_sdk

    Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk.

    166 GitHub starsUsed in 5 repos~806 tokens
    DevelopmentAuto-check passed

  • Design Doc Mermaid

    SpillwaveSolutions/design-doc-mermaid

    Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.

    175 GitHub starsUsed in 1 repo~5.6k tokens
    DevelopmentAuto-check passed

  • Learning Opportunities

    DrCatHicks/learning-opportunities

    Facilitates deliberate skill development during AI-assisted coding.

    2.5k GitHub stars~2.5k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from managedcode/Storage

All 41 skills in this repo

  • Mcaf Agile Delivery

    managedcode/Storage

    Shape delivery workflow around backlog quality, roles, ceremonies, and engineering feedback.

    138 GitHub stars~883 tokensUpdated yesterday
    Auto-check passed

  • Mcaf Architecture Overview

    managedcode/Storage

    Create or update docs/Architecture.md as the global architecture map for a solution.

    138 GitHub stars~950 tokensUpdated yesterday
    Auto-check passed

  • Mcaf CI CD

    managedcode/Storage

    Design or refine CI/CD workflows, quality gates, release flow, and safe AI-assisted pipeline authoring.

    138 GitHub stars~981 tokensUpdated yesterday
    Auto-check passed

  • Mcaf Code Review

    managedcode/Storage

    Prepare for, perform, or tighten code review workflow: PR scope, review checklist, reviewer expectations, and merge hygiene.

    138 GitHub stars~957 tokensUpdated yesterday
    Auto-check passed

  • Mcaf Devex

    managedcode/Storage

    Improve developer experience for multi-component solutions: onboarding, F5 contract, cross-platform tasks, local inner loop, and reproducible setup.

    138 GitHub stars~911 tokensUpdated yesterday
    Auto-check passed

  • Mcaf Documentation

    managedcode/Storage

    Create or refine durable engineering documentation: docs structure, navigation, source-of-truth placement, and writing quality.

    138 GitHub stars~893 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Mcaf Adr Writing

What does Mcaf Adr Writing do?

Create or update an ADR under docs/ADR/ for architectural decisions, dependency changes, data-model changes, or cross-cutting policy shifts. Mcaf Adr Writing is an agent skill from managedcode/Storage. Create or update an ADR under docs/ADR/ for architectural decisions, dependency changes, data-model changes, or cross-cutting policy shifts.

When should I use Mcaf Adr Writing?

Mcaf Adr Writing fits situations like: the user asks to write; document an ADR; record a design decision; capture architecture trade-offs.

How do I install Mcaf Adr Writing in Claude Code?

Run `npx skills add managedcode/Storage --skill mcaf-adr-writing -a claude-code`. Or copy the skill folder (.codex/skills/mcaf-adr-writing in managedcode/Storage) into .claude/skills/mcaf-adr-writing in your project. Claude Code loads it when a task matches its description.

How do I install Mcaf Adr Writing in Codex?

Run `npx skills add managedcode/Storage --skill mcaf-adr-writing -a codex`. Or copy the skill folder (.codex/skills/mcaf-adr-writing in managedcode/Storage) into .agents/skills/mcaf-adr-writing in your project. Codex loads it when a task matches its description.

Can I use Mcaf Adr Writing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add managedcode/Storage --skill mcaf-adr-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcaf-adr-writing, .gemini/skills/mcaf-adr-writing, .github/skills/mcaf-adr-writing and .opencode/skills/mcaf-adr-writing in your project.

What does Mcaf Adr Writing need to run?

SKILL.md names no scripts, command-line tools or credentials: Mcaf Adr Writing is instructions for the agent only. Compatibility (from SKILL.md): Requires repository write access; produces Markdown ADRs with Mermaid diagrams..

Does Mcaf Adr Writing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Mcaf Adr Writing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mcaf Adr Writing use?

Mcaf Adr Writing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mcaf Adr Writing use?

About 951 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Mcaf Adr Writing?

Skills that share tags, products or a category with Mcaf Adr Writing: PR Design Doc (OpenHands/OpenHands, 90k stars), Cto Advisor (Ibrahim-3d/orchestrator-supaconductor, 380 stars), Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars) and Domain Modeling (brim-borium/spotify_sdk, 166 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mcaf Adr Writing?

managedcode (a GitHub organization) maintains it in managedcode/Storage, which has 138 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 7, 2026.

Source: managedcode/Storage on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.