Skip to content
Back to search

claude-skills-workshop

Beginner workshop: learn to build Claude Code skills in ~3 hours

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nikil1506--claude-skills-workshop/badge.svg)](/listings/nikil1506--claude-skills-workshop)

HTML

<a href="/listings/nikil1506--claude-skills-workshop"><img src="/api/listings/nikil1506--claude-skills-workshop/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 38 lines
  1. # Learn to build Claude Code skills
  2. **A skill is a folder with a text file that teaches Claude how to do one job your way.**
  3. You write plain English instructions once. Claude loads them automatically when your request matches. No coding needed for the basics.
  4. You will build real skills in about 3 hours, one small step at a time.
  5. ## What you need
  6. - [Claude Code](https://code.claude.com/docs) installed and signed in
  7. - Git and Python 3.9+ (only for the checker script and one lesson)
  8. - This repo, opened in your terminal: `cd claude-skills-workshop` then run `claude`
  9. ## The path (do them in order)
  10. | # | Lesson | You will | Time |
  11. |---|---|---|---|
  12. | 0 | [What is a skill?](lessons/00-what-is-a-skill.md) | read, and look at a finished skill | 10 min |
  13. | 1 | [Your first skill](lessons/01-your-first-skill.md) | build `explain-code` and see it work | 25 min |
  14. | 2 | [The description is everything](lessons/02-description.md) | fix a skill that never triggers | 25 min |
  15. | 3 | [Add a script](lessons/03-add-a-script.md) | let a script do the exact work | 25 min |
  16. | 4 | [Add a reference file](lessons/04-add-a-reference.md) | keep the skill short and the details separate | 20 min |
  17. | 5 | [Test it and improve it](lessons/05-test-and-improve.md) | check it triggers when it should and stays quiet when it shouldn't | 25 min |
  18. | 6 | [Share it](lessons/06-share-it.md) | personal vs project skills, and git | 15 min |
  19. | 7 | [Your own skill](lessons/07-your-own-skill.md) | build one for a task from your real work | 45 min |
  20. One-page summary: [CHEATSHEET.md](CHEATSHEET.md). Stuck? Every lesson ends with "If it doesn't work", and finished versions are in [solutions/](solutions/) (try first, peek second).
  21. ## What is in this repo
  22. - `lessons/` the steps
  23. - `sample-project/` a tiny Python project your skills practise on
  24. - `.claude/skills/` two ready-made skills: `commit-message` (a good one to study) and `notes-helper` (a broken one you fix in Lesson 2). Claude Code loads skills from here automatically.
  25. - `templates/` a skill template and a test sheet
  26. - `scripts/validate_skill.py` a checker that tells you what is wrong with a skill, in plain words
  27. - `solutions/` finished versions of every lesson
  28. ## Check your work any time
  29. ```
  30. python scripts/validate_skill.py .claude/skills/explain-code
  31. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.