...
Author and ship one agent skill across every major SKILL.md runtime from a single source. Use this skill when you maintain (or want to start maintaining) the same instruction file as SKILL.md (Claude Code / OpenCode / OpenAI Codex / Hermes / OpenClaw / Cursor / Windsurf 2026 consumers), AGENTS.md (AAIF — Codex CLI, Copilot, Gemini CLI, VS Code, Jules, Factory, Devin, Amp), MCP-SERVER.md, and CLAUDE.md, and the four files keep drifting after every edit. Write one `.mda` (a Markdown superset with rich YAML frontmatter, typed footnote relationships, and JCS-canonical integrity digest + Sigstore-anchored DSSE signatures), and use the `@markdown-ai/cli` (`mda`) reference compiler to validate the source, compile drop-in `.md` outputs for the targets you want, validate each output against its JSON Schema, and integrity-verify before shipping. Triggers - "compile one skill to multiple agent runtimes", "stop duplicating SKILL.md and AGENTS.md", "sign / digest / tamper-evidence for a skill artifact", ".mda compile / validate / sign / verify", "publish skill to agentskills.io and AAIF at once". Skip - generic prose Markdown, runtimes outside the agentskills.io v1 / AAIF subset (Cursor MDC, Windsurf rules, Continue, Aider, `*.instructions.md` still need parallel maintenance), or any project that only ever loads one runtime's file format.
作成者: songlin she · GitHub