Skip to content

Instantly share code, notes, and snippets.

@jcohen66
Created July 14, 2026 21:58
Show Gist options
  • Select an option

  • Save jcohen66/47ce79540172b1e0813fd9676835cfc9 to your computer and use it in GitHub Desktop.

Select an option

Save jcohen66/47ce79540172b1e0813fd9676835cfc9 to your computer and use it in GitHub Desktop.
AI Anatomy of a Claude Skill #ai #claude #skill #anatomy

Name

The unique descriptive name of the skill

Description - [What it does] + [When to use it]

Use this whenever the user [situation], says "[phrase]", "[phrase]", or wants to [task] -- even if they don't say "[skill name]" directly.

Purpose - [What this does]

[One sentence a brand-new hire would understand.]

Step - In the order you actually do them

  1. [First step] -- because [reason]
  2. [Second step] -- because [reason]
  3. [Third step] -- because [reason]

Format & Output

Length: [exact -- 3 bullets / 150 words / one page] Tone: [pick 2 -- direct, warm, confident, casual] Structure: [headings / table / numbered list].

Always Do

  • Always [rule]
  • Replace [jargon] with [plain word]

Never Do

  • Never [the mistake you keep correcting]

Examples

Good output looks like this: [paste a real finished result you'd be happy with] Weak output looks like this: [Paste a bad version + one line on why it's wrong]

When unsure

Ask before guessing. List questions, don't fill gaps silently.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment