omd:add-reference

SkillMedia

Reference catalog authoring compatibility gate. Blocks new legacy DESIGN.md writes until the Core v2 cutover is complete and explains safe resumption conditions.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the omd:add-reference skill

What this skill tells your AI

The instructions your AI receives, as published by kwakseongjae/oh-my-design in .agents/skills/omd-add-reference/SKILL.md and read by ahel’s review.

Status: CORE_V2_CATALOG_WRITE_BLOCKED.

This repository still reads the 440 historical reference files through the legacy frontmatter adapter. That makes them valid migration inputs, but it does not authorize a new legacy writer. Do not create, update, backfill, or sync a web/references/<id>/DESIGN.md from this skill.

When invoked:

  1. Inspect only. Do not write a reference, token block, generated catalog, or public count.
  2. Explain that project/user-facing DESIGN.md is already single-write Core v2, while reference authoring is paused until the catalog has a graph-backed metadata/evidence package and Core projection compiler.
  3. If research is still useful, save nothing to the catalog. Return a concise proposed source list and the intended reference id in chat only.
  4. Resume writes only after all of these exist and pass together:
    • Core v2 reference metadata/evidence sidecar schema;
    • registry, quality, AST, token, and verification readers for that schema;
    • deterministic graph → portable DESIGN.md projection;
    • legacy dual-read and Core single-write tests;
    • migration report with dropped_segments=0 and unknown facts absent.

Never work around this gate by restoring a legacy YAML marker, numbered 13/15/16 sections, placeholder sentinels, or a second authoritative Markdown dialect.

Signals

GitHub stars
500
Forks
45
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
omd-add-reference
Source
github.com/kwakseongjae/oh-my-design