docs.
everything you need to use a skill after purchase. five-minute read.
01 — what a skill is
a skill is a single markdown file (SKILL.md) with two parts:
1. yaml frontmatter — declares when to invoke, required inputs, brand-brain fields, and version metadata.
2. markdown body — declares the process, decision rules, output format, and edge cases.
that's the whole spec. no compiler, no installer, no runtime. claude reads the file, follows the body, returns the artifact. you own the file.
02 — quickstart (claude code)
after purchase, click the download link in your delivery email. you get a SKILL.md file (one per single-skill purchase, or a zip of every catalog skill if you bought the library).
drop it into your claude code skills directory:
~/.claude/skills/<skill-name>/SKILL.mdrestart claude code (or run /skills reload). claude auto-discovers any SKILL.md in that path. invoke by description match — no slash command required, but you can wire one if you want.
03 — compatible harnesses
skills are framework-agnostic. tested on:
- claude code (CLI) — drop into ~/.claude/skills/
- claude desktop (mac/windows) — same path
- opencode — drop into .opencode/skills/
- cursor agents — paste into rules or attach as context
- any agent harness that reads markdown — paste the body into a system prompt
the portability is the point. no vendor lock-in.
04 — frontmatter contract
every skill ships with a frontmatter block at the top. typical fields:
yaml --- name: ads_copy description: generate platform-specific dtc ad copy variants... license: Skillor Commercial License v1.0 pack: dtc-marketer-mvp version: 1.0.0 priority_score: 10 dtc_use_case: "brand needs 8 fresh meta ad concepts..." brand_brain_fields: [voice, audience, offers] ---claude reads this when deciding whether to invoke the skill. fields: - `name`: machine-friendly id (snake_case). - `description`: when claude should use this skill. write it for claude, not for marketing. - `license`: terms governing your use. most skills are commercial-licensed; funnel_audit is MIT. - `priority_score`: 0–10. claude prefers higher scores when multiple skills match. - `brand_brain_fields`: which brand brain sections must be present in context.
05 — brand brain integration
many skills reference `{{brand.voice}}`, `{{brand.audience}}`, `{{brand.offers}}` — these are placeholders for sections of your brand brain (a separate document you maintain with brand voice, ICP, KPIs, offers).
you don't need a brand brain to use the skills. claude will ask for the missing context inline. but if you have one, drop it into ~/.claude/context/brand-brain.md and skills will pull from it automatically.
recommended sections: identity, voice, audience, offers, kpis, channels, calendar.
06 — modify, ship, what you can't do
skillor commercial license. plain-language summary (full terms at /legal/license):
you CAN:
- use the skill in your own dtc work or client deliverables
- modify the file privately for your own / clients' use
- ship the OUTPUTS claude produces (ad copy, audits, flows) however you want — those are 100% yours
- keep using the file forever, even if skillor shuts down
you CANNOT:
- redistribute the SKILL.md file in public (github, gist, paid product, free download)
- resell or sublicense the file as your own product
- share your purchased copy with others who haven't bought their own license
exception: one skill (funnel_audit) is open-sourced under MIT as a public sample. always check the `license:` field in the file's frontmatter.
07 — updates + versioning
all v1.x updates are free for the life of v1. when a skill is updated, we email past buyers with a fresh download link. semver: minor versions (1.1, 1.2) add features non-breakingly; patch versions (1.0.1) fix bugs. major versions (v2) are a separate release.
you can opt out of update emails via the unsubscribe link.
08 — support
email support@skillor.app. solo operator. expect 24h reply.
for refund requests, see /legal/refund. for privacy questions, /legal/privacy.
bug in a skill? open an email with subject 'bug — [skill name]' + a 3-line repro. we ship a fix within 1 week if confirmed.