SkillsMay 14, 2026·2 min read

MDA — Compile One Doc into SKILL/AGENTS/CLAUDE

MDA is a Markdown superset for docs; verified 559★. One `.mda` compiles into SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md via `@markdown-ai/cli`.

Prompt Lab
Prompt Lab · Community
Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Needs Confirmation · 66/100Policy: confirm
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Single
Trust
Trust: Community
Entrypoint
Asset
Universal CLI install command
npx tokrepo install 91009399-93b4-5d99-8756-3448d698f8a8
install contractmetadata JSONadapter planraw content
Intro

MDA is a Markdown superset for docs; verified 559★. One .mda compiles into SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md via @markdown-ai/cli.

Best for: Teams maintaining multiple agent doc formats that keep drifting out of sync

Works with: agentskills.io SKILL.md, AAIF-style AGENTS.md, MCP-SERVER.md, and CLAUDE.md consumers; Node-based CLI workflows

Setup time: 10-20 minutes

Key facts (verified)

  • GitHub: 559 stars · 14 forks · pushed 2026-05-11.
  • License: Apache-2.0 · owner avatar + repo URL verified via GitHub API.
  • README-backed entrypoint: npm install -g @markdown-ai/cli.

Main

  • Treat .mda as the single source of truth, then compile drop-in docs for multiple runtimes instead of duplicating content by hand.

  • Use mda validate and the target schemas as a CI gate so published SKILL/AGENTS/CLAUDE artifacts stay structurally correct.

  • Use integrity digests (--integrity) and mda integrity verify when you need tamper-evident docs in agent supply chains.

Source-backed notes

  • README describes .mda as a Markdown superset that compiles into SKILL.md, AGENTS.md, MCP-SERVER.md, and CLAUDE.md outputs.
  • CLI manual states the npm package is @markdown-ai/cli and the installed binary/command is mda.
  • CLI manual shows a minimal flow: mda init → mda validate → mda compile --integrity → mda integrity verify.

FAQ

  • What command does the CLI install?: The CLI manual says @markdown-ai/cli installs one command: mda.
  • Can I run it without installing?: Yes — CLI manual shows npx @markdown-ai/cli --help as a no-install entry point.
  • What should I verify in CI?: Validate both the .mda source and emitted targets, then run mda integrity verify for integrity checks.
🙏

Source & Thanks

Source: https://github.com/sno-ai/mda > License: Apache-2.0 > GitHub stars: 559 · forks: 14

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Prompt Master — Zero-Waste AI Prompt Generator Skill

Claude Code skill that generates optimized prompts for 30+ AI tools. Auto-detects target tool, applies 5 safe techniques, catches 35 credit-killing patterns. 4.8K+ stars, MIT license.

Skills
Prompt Lab

Multi-Platform Social Media Growth Skill for Developer Communities

Production-tested Claude Code skill for automating authentic developer engagement across 10+ platforms (Twitter, Bluesky, Dev.to, HN, Reddit, GitHub, Product Hunt, Hashnode, Medium, Quora). Includes rotation queue, per-platform cooldowns, action diversity rules, Chrome MCP toolchain with JS injection patterns, anti-ban safety, and continuous optimization framework. Battle-tested across 30+ cycles.

Skills
henuwangkai· ⭐ 1

Get Shit Done (GSD) — Meta-Prompting Dev System for Claude Code

A spec-driven development system with 48.6k GitHub stars. Adds phase-based planning, multi-agent execution, verification gates, and state persistence to Claude Code, Cursor, Gemini CLI and 9 more runtimes. Install with one npx command.

Skills
henuwangkai

Remotion AI Video Production Skill — Cinema-Grade Short Videos

Pushed via CLI: video-production-skill-push.md

Skills
henuwangkai· ⭐ 1
◈Home🔍Search👤Me