GitHub - tannerjames711/mdstitch: npm but for agend.md and skill.md files

2 min read Original article ↗

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


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.