Skills now come in two formats. Alongside the structured format you already know—instructions organized into categories—you can now author a skill as free-form Markdown.
Both are first-class. The only difference is how you write the content; everything about how skills are delivered to your AI stays exactly the same.
Why Markdown?
The thing that makes SuperClawd skills reliable isn't the structure—it's the delivery: skills load on demand when their action matches your work, get re-injected with full fidelity, and never get lost to context compacting.
That delivery doesn't care whether your content is a tidy category tree or a page of markdown. So if you already have guidelines written as prose, or you just want full control over formatting, you no longer have to break them into categories and instructions. Paste the markdown and you're done.
Structured vs Markdown
| Structured | Markdown | |
|---|---|---|
| Content | Categories → instructions → conditionals | A single free-form markdown body |
| Best for | Granular, reusable building blocks | Prose-style guidelines, full formatting control |
| Limits | Up to 10 categories × 10 instructions × 8 conditionals | Body up to 12,000 characters |
| Delivery | Loaded on demand by action | Loaded on demand by action |
Pick the format when you create a skill. (It can't be changed afterward—but you can always create a new one.)
Authoring a Markdown Skill
- Click New Skill and choose the Markdown format
- You're taken to a markdown editor—write your instructions
- Save, and you'll see the skill's character and token counts in the list
That's it. The markdown is delivered verbatim to your AI whenever the skill activates.
Import, Export, and the Community
Markdown skills export and import as JSON just like structured ones—the file simply carries a body instead of categories. Skills you exported before this change keep working unchanged: anything without a format field imports as structured.
The community repository accepts both formats too, so you can share whichever fits your skill.
Try It
Open your workspace, head to Skills, click New Skill, and give the Markdown format a try. We'd love to hear which format you reach for—and why.