10 min / beginner / 5 steps
Create Your First Skill in 10 Minutes
Turn a task you do every week into a single command. Copy, paste, done.
Skills are markdown files that teach Claude how to do specific tasks. Instead of typing the same instructions over and over, you write them once and Claude follows them every time. Think of it like creating a custom command. Let's make a code review skill.
follow along in
You need: A Claude account. Open claude.ai in a browser, or the Claude desktop app.
step 01 / 05
Create the skills directory
Skills live inside the .claude/skills folder in your project. Each skill gets its own folder, named after the skill, with a SKILL.md file inside. Create the folder for your first one.
PromptPaste into ClaudeI want to create a reusable code review skill for Claude. How do I set this up in the app?what you should see
Create the skills directorymy-projectShareDescribe a task or ask a question+Accept editsstep 02 / 05
Create a code review skill
Create a markdown file that tells Claude exactly how to review code. This is where the magic happens. You define the rules, the format, the tone, everything.
PromptPaste into ClaudeHere are the instructions I want you to follow every time I ask for a code review: Check for: security vulnerabilities, performance issues, missing error handling, unclear naming. Rate each issue: CRITICAL, HIGH, MEDIUM, or LOW. Format: file path, line number, severity, issue, fix suggestion. Be direct. If the code is good, say so briefly.what you should see
Create a code review skillmy-projectShareDescribe a task or ask a question+Accept editsstep 03 / 05
Test it with a real review
Now use the skill. Ask Claude to review your recent changes and watch it follow your exact format.
PromptPaste into ClaudeReview this code: const API_KEY = "sk-live-abc123"; async function getUsers() { const users = await db.query("SELECT * FROM users"); return users.map(u => db.query(`SELECT * FROM orders WHERE user_id = ${u.id}`)); }what you should see
Test it with a real reviewmy-projectShareDescribe a task or ask a question+Accept editsstep 04 / 05
See the skill activate
Notice how Claude followed your exact format, with severity ratings, file paths, and specific fixes. That's not coincidence. That's your skill definition driving the output.
PromptPaste into ClaudeWhy is the output so much better when I give you those instructions upfront?what you should see
See the skill activatemy-projectShareDescribe a task or ask a question+Accept editsstep 05 / 05
Customize it for your team
Now make it yours. Add your team's specific rules, coding standards, or things that always get missed in reviews. The skill grows with you.
PromptPaste into ClaudeAdd these rules to my code review instructions: - All API routes must have rate limiting - Database queries must use the repository pattern - React components must have error boundaries - No inline styles, Tailwind classes only - All public functions need JSDocmarkdown# Add these to your code-review.md: ## Team-Specific Rules - All API routes must have rate limiting - Database queries must use the repository pattern - React components must have error boundaries - No inline styles, use Tailwind classes only - All public functions need JSDoc commentswhat you should see
Customize it for your teammy-projectShareDescribe a task or ask a question+Accept edits
Tell someone what you built
Just finished "Create Your First Skill in 10 Minutes" on Claude Code Guide. Took about 10 min, and it's free: https://claudecodeguide.dev/tutorials/your-first-skill
New guides, when they ship
One email, roughly weekly. CLAUDE.md templates, workflows I actually use, and the cut-for-length stuff that does not make the public guides. One-click unsubscribe.
Or read Product Field Notes, the Substack