C.W.K.
Stream
Lesson 01 of 07 · published

What a Skill Is

~14 min · skills, skill-md, open-standard, portable

Level 0🌱 Novice
0 XP0/70 lessons0/11 achievements
0/120 XP to next level120 XP to go0% complete

A folder Claude reads when it needs to be precise

A Skill is a folder containing a SKILL.md (instructions + frontmatter), optional supporting files (templates, checklists, schemas), and optional scripts. The host AI loads it dynamically when relevant — explicitly via /skill-name, automatically based on the description, or always-on per Skill config. Same shape across every compliant tool.

Why this exists: prompt drift. The same task asked five different ways gets five different outputs. Skills move the canonical instructions out of conversation memory and into a versioned file. The agent reads the same instructions every time; the output stays consistent across users, sessions, machines.

Skills follow the open Agent Skills standard. A well-written Skill works in Claude Code, Cowork, and third-party tools that implement the spec — write once, deploy across the agent landscape. That portability is the whole reason the standard exists.

Code

Minimum viable Skill·markdown
---
name: pr-summary
description: |
  Summarize a GitHub pull request: changed files, intent, risks.
invocation: explicit
arguments:
  - name: pr_url
    required: true
---

You are reviewing a GitHub pull request at {{pr_url}}.

Produce:
1. One-sentence intent ("what does this PR want to change?")
2. Files changed, grouped by purpose
3. Risk callouts (auth, payments, schema, public API)
4. Two questions you'd ask the author
Skill folder layout·text
.claude/skills/pr-summary/
├── SKILL.md           ← frontmatter + body
├── templates/
│   └── summary.md     ← output template
└── checklists/
    └── risks.md       ← reference loaded via paths:

External links

Exercise

Pick one prompt you find yourself retyping. Convert it to a Skill — frontmatter with description + arguments, body with the canonical instructions. Run it twice on different inputs. Note the consistency dividend.

Progress

Progress is local-only — sign in to sync across devices.
Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)
Sign inPlease sign in to comment.

No comments yet — be the first.