Give this skill to your agent
Paste this instruction into your assistant, coding agent, or project-level agent rules. It tells the agent when and how to use mdtidy.
SKILL.md
Drop this into a file named
SKILL.md in your project, or paste it into your agent’s system prompt. The HTTP example is generated from our live API schema, so it can’t drift.# mdtidy Skill
Use mdtidy when the user asks to clean, format, normalize, or prepare Markdown.
## When to use
Use mdtidy for:
- messy Markdown
- copied content with broken formatting
- Markdown that needs to be made readable
- Markdown that should be optimized for LLMs
- notes, docs, prompts, or content that need consistent structure
## How to use
Send the Markdown content to the mdtidy API using the user's API key.
```http
POST https://markdowntidy.com/api/v1/convert
X-API-KEY: <user's API key>
Content-Type: application/json
{
"markdown": "<the content to clean>",
"format": "text",
"actions": ["clean", "repair"]
}
```
Supported `format` values: html, text, pdf, docx, png.
The response includes `output` (cleaned content as a string when `format` is
`html` or `text`), or `outputBase64` (base64-encoded body when `format` is
pdf, docx, png). Every response also includes `creditsCharged`,
`creditsRemaining`, and `requestId`.
Return the cleaned content to the user.
## Rules
- Preserve the original meaning.
- Do not remove important content.
- Do not invent new content unless the user asks.
- Keep headings, lists, links, tables, and code blocks valid.
- Prefer clean, readable Markdown.
What to do next
Three quick steps after copying the skill.
1. Save the SKILL.md alongside your project (Cursor reads .cursorrules; Claude Code reads CLAUDE.md; other agents accept a system prompt or memory file).
2. Make sure you have an active API key on your account and store it securely — agents will need it.
3. Try one of the example prompts in your agent.