🪡 mdstitch

Like npm but for agent.md and skill.md files... but also with other cool features.

npm install -g mdstitch

Package management

Publish your agent or skill files to the mdstitch registry, and pull them into any project instantly.

| Command | Description | |---|---| | mdstitch signup | Create an account | | mdstitch login | Log in | | mdstitch publish <file> | Publish an agent.md or skill.md file as a package | | mdstitch add <package_name> | Install a package into a folder — creates <package_name>/ with agent.md or skill.md and any reference files | | mdstitch addref <package_name> <file> | Attach a plain text reference file (.py, .js, .ts, .txt, .json, .csv, etc.) to a package | | mdstitch removeref <package_name> <file> | Remove a reference file from a package | | mdstitch update <package_name> <file> | Push an updated version of a package |

Annotations

Annotations let you embed live data and protect sensitive content directly in your markdown files.

@excel(file, sheet, range)

Pulls a table from an Excel file and replaces the annotation with structured instructions an AI agent can use to recreate or work with the data.

@excel(report.xlsx, results, A1:E10)

Expands to a markdown table with column types, calculation logic, and row data.

@secret(start) / @secret(end)

Wraps content that should be stripped before publishing. Anything between these tags is removed when you run mdstitch publish — keeping private context local while sharing the rest.

@secret(start)
INTERNAL_API_KEY=abc123
@secret(end)

File commands

| Command | Description | |---|---| | mdstitch run <file_name> | Activate all annotations in a file | | mdstitch compress <file_name> | Shrink file size for token efficiency | | mdstitch pretty <file_name> | Restore compressed file to readable markdown |

More annotations coming soon.