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 version: "1.0.0" description: > One to two sentences. Start with a verb. What does it do? What does the output look like? license: MIT triggers: - the phrase that activates this skill - a variation of that phrase rules: - concrete, testable rule #1 - concrete, testable rule #2 --- The rules section 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. Our scraper validates the SKILL.md schema and a human reviewer publishes it within 24 hours. Step 5 — iterate publicly -------------------------- Tag your releases. Write a one-line changelog. Reply to issues within a day. The difference between 50 stars and 5,000 isn't quality — it's visibility and responsiveness. Check the full publishing guide at claudeskil.com/docs/create for the complete SKILL.md specification and review checklist.