Documentation
README
Skills are just Markdown files with frontmatter. If you can write a README, you can write a skill. Here's how to create one from scratch, audit it, and share it.
What Is a Skill?
A skill is a SKILL.md file inside a named directory. It contains instructions that AI coding tools (Claude Code, Cursor, Codex, etc.) load as context when working on your code.
my-skill/
โโโ SKILL.md
That's the minimum. The SKILL.md file has two parts: frontmatter (metadata) and body (the actual instructions).
Step 1: Scaffold with skillshare new
skillshare new my-code-review
This creates ~/.config/skillshare/skills/my-code-review/SKILL.md with a template:
This is the opening of the README. Read the full README on GitHub.