Skip to content
Skills Library
AI & agents · Building & coding

write-a-skill

/write-a-skill

Help the user create a new Claude Code skill (SKILL.md). Use when user wants to automate a recurring workflow or capture a reusable instruction set.

Licence
MIT
Last repository change
17.06.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 17.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Help the user create a new Claude Code skill (SKILL.md). Use when user wants to automate a recurring workflow or capture a reusable instruction set.

Original author description

Help the user create a new Claude Code skill (SKILL.md). Use when user wants to automate a recurring workflow or capture a reusable instruction set.

How it works

  1. Process
  2. Good skill anatomy
  3. Tips
Original SKILL.md headings · 45 lines, 212 words
SKILL.md preview
---
name: write-a-skill
description: Help the user create a new Claude Code skill (SKILL.md). Use when user wants to automate a recurring workflow or capture a reusable instruction set.
triggers: ["write a skill", "create a skill", "new skill", "make a skill", "I keep doing this manually"]
---

# Write a Skill

Help the user turn a recurring workflow into a reusable Claude Code skill.

## Process

1. **Understand the workflow**: ask what task the user repeats. What triggers it? What does success look like?
2. **Draft a SKILL.md**:
   - YAML frontmatter: `name`, `description`, `triggers` (3-5 phrases that activate it)
   - Body: concise instructions Claude follows when the skill activates
   - Include steps, examples, and what NOT to do
3. **Write the file**: create `~/.claude/skills/<name>/SKILL.md` with the draft
4. **Test it**: ask the user to start a new session and trigger the skill by saying one of the trigger phrases
5. **Iterate**: refine based on what felt off in the test

## Good skill anatomy

```
---
name: my-skill
description: One sentence. When to use it.
triggers: ["phrase 1", "phrase 2", "phrase 3"]
---

# My Skill

What Claude does when this skill activates. Be concrete.

## Steps
1. ...
2. ...

## Examples
**User:** [trigger phrase]
**Claude:** [response]
```

## Tips

- Keep it under 200 lines — skills should be focused
- Triggers should be natural phrases the user actually says
- One skill = one workflow. Don't bundle unrelated things.
- If the skill needs reference data (e.g. API docs), add a separate file and reference it

Versions

RepositoryScoreLicence
This page · gyuch-an02/claude-omakase100MIT
borghei/Claude-Skills100MIT
alirezarezvani/claude-skills100MIT
redpanda-data/ui-harness100MIT
RubenGlez/rubstack100MIT
holl4ndtv/skills100MIT
yamcodes/arkenv100MIT
mkurman/zorai100MIT
AmirAzy/HoNspot100MIT

Database snapshot: 13.11.2026 · package version 6a48ca157670 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100create-skill-claude
    Use this skill when the user asks to "create a skill", "add a skill", "make a new skill", "build a skill", or wants to automate a repeated workflow into a reusable prompt. Guides creating a properly structured Claude Code skill.
  • 95make-skill
    Create a focused workspace Skill from reusable decisions, knowledge, templates, or workflows in the current conversation. Use for /make-skill with a focus argument and requests such as save this workflow or turn this into a skill; do not use for one-off summaries or ordinary file creation.
  • 100skill-creator
    Scaffold, author, and validate an Agent Skill. Use when the user wants to create a new skill, turn a repeatable workflow into a reusable SKILL.md, or fix a skill that fails to load.
  • 100skill-development
    This skill should be used when the user asks to create a new skill, repair an existing skill, improve trigger descriptions, reorganize skill structure, or make a Claude skill more reusable and internally consistent.
  • 100skill-creator
    Create a new skill that packages a workflow into a reusable SKILL.md. Use when the owner says "create a skill", "make a new skill", "turn this into a skill", or asks to build a reusable process. Also called as a sub-step by promote-skills to draft candidate bodies.
  • 100create-skill
    Turn a repeatable AI prompt or workflow into a structured, shareable skill for the affiliate-skills GitHub repository. Use this skill when the user wants to create a new skill, write a SKILL.md, convert a prompt to a skill, share a skill via the GitHub repo, or document an AI…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.