# Hyalo Madr

> Maintain Markdown Architecture Decision Records with Hyalo's MADR profile and table-of-contents commands.

- Skill: `ractive/hyalo-madr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add ractive/hyalo-madr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ractive/hyalo-madr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: ractive (https://skillmd.com/u/ractive)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/ractive/hyalo-madr

---


<!-- hyalo:managed -->

# Architecture decision records

Inspect `hyalo config`, `hyalo types show adr`, and `hyalo madr --help`.
Use `hyalo lint --profile madr --format text` for conformance and
`hyalo madr toc --dry-run` to inspect table-of-contents drift.

Keep numbering, status transitions, supersession links, and the configured ADR path
consistent with the existing collection. Use the relevant command's help before creating
or superseding records. Do not infer that an accepted decision is superseded from age alone.
Apply requested metadata changes with Hyalo and prose with ordinary editing tools.
After edits, lint affected records and preview the table of contents again.