@m-d-t/skills

Agent skills for mdt — the markdown template synchronization tool.

What's inside

This package provides a pi-compatible agent skill that teaches your coding agent how to work with mdt. When installed, agents can:

• Create and manage provider/consumer template blocks
• Run mdt check, mdt update, and other CLI commands correctly
• Use MCP tools (mdt_find_reuse, mdt_preview, mdt_check, etc.) with best practices
• Apply the right transformers for source-file doc comments (Rust, TypeScript, Python, Go, etc.)
• Configure mdt.toml for data interpolation, padding, and scanning rules

Installation

As a pi package

pi install npm:@m-d-t/skills

Or try it for a single session:

pi -e npm:@m-d-t/skills

As a project-level dependency

Add to your .pi/settings.json:

{
	"packages": ["npm:@m-d-t/skills"]
}

Then any contributor running pi in the project will automatically get the skill.

Requirements

• mdt CLI installed (npm install -g @m-d-t/cli or cargo install mdt_cli)
• For MCP integration: an mdt MCP server configured in your agent (mdt mcp)

What the skill covers

Topic	Description
Template syntax	Provider ({@}), consumer ({=}), inline ({~}), close ({/}) tags
Transformers	trim, indent, linePrefix, codeBlock, replace, if, and more
Data interpolation	Pull values from JSON, TOML, YAML, KDL, INI, or script output
Source file support	Consumer blocks in .rs, .ts, .py, .go, .java, etc.
MCP tools	Full reference for all 7 MCP server tools with best practices
Configuration	mdt.toml sections: [data], [padding], [exclude], [templates]
CLI commands	init, check, update, list, info, doctor, assist, lsp, mcp

Links

• mdt repository
• Documentation
• CLI binary package