How to publish your first skill on ClaudeSkill

You have a system prompt that works. Now turn it into a skill people will install.

Step 1 — name it for the job

Skills named after roles beat skills named after models or tools. "SEO Content Optimizer" is found by people searching for SEO help. "GPT-4 Turbo Prompt v3" is found by nobody. Your user's mental model is "hire someone who does X."

Step 2 — write the SKILL.md

Create a SKILL.md in the root of a new GitHub repo:

---
name: your-skill-name
description: One to two sentences. Start with a verb. What does it do? What does the output look like? When should Claude use it?
license: MIT
---

# Your skill name

## Rules
- concrete, testable rule #1
- concrete, testable rule #2

There is no triggers field: Claude reads the name and description up front and loads the rest of the file when a request matches the description, so write the description in the words people use when they need the skill. The rules section of the body is the most important part. Each rule should be falsifiable — you should be able to look at an output and say whether the rule was followed or not.

Step 3 — ship a README, not a manifesto

Three headers: What it does, Install, How it works. Keep it under a page. Anything longer and people close the tab. Add one worked example — an input and the expected output.

Step 4 — publish to GitHub, then submit here

Open-source it (MIT or Apache-2.0), then submit the repo URL at claudeskil.com/submit. Submissions are reviewed before they're published.

Step 5 — iterate publicly

Tag your releases. Write a one-line changelog. Reply to issues within a day.

Check the publishing guide at claudeskil.com/docs/create, and Anthropic's Claude Code documentation for the complete SKILL.md format.