Free Skill Generator (+ Guide)

What is a skill generator?

A skill generator writes the files for an Agent Skill from a few fields, in the format the agents read.

This one starts from the sections each kind of skill needs, checks the result against the rules in Anthropic's docs, Codex's docs and the open Agent Skills spec, and zips the folder for you.

What is an Agent Skill?

An Agent Skill is a folder that teaches an AI agent one job, like writing commit messages, reviewing code or following a brand's style.

The agent loads it in 3 stages, so you can install many skills without filling its memory:

That's why a vague description is the most common reason a skill never loads.

Skills vs CLAUDE.md vs prompts

Each one does a different job, and the best setups use all 3:

Keep the agent file short, and give the agent a skill for each job you repeat.

The anatomy of a great skill

A skill is a folder named after the skill, with these parts:

Only SKILL.md is required. Keep it under 500 lines, and link each reference file straight from it, one level deep.

How to write a description that loads at the right time

The description is what the agent matches each request against, so write it for that moment:

• Say what the skill does and when to use it
• Write it in the third person, like "Processes Excel files", never "I can help you"
• Use the words people say when they need it: file types, tool names, tasks
• Stay under 1,024 characters, or 200 for the Claude apps

A description like "Helps with documents" never loads at the right time, because it matches everything and nothing.

5 kinds of skills and when to use each

Most skills fit one of these kinds, and the generator starts each one with its own sections:

Press Try an example to see a style skill of my own: the rules I write by on navid.me.

How to test and install a skill

Test a skill before you rely on it:

In Claude Code, a skill goes in ~/.claude/skills for all your projects, or .claude/skills in one project. Codex reads ~/.agents/skills or .agents/skills, and the Claude apps take the zip under Customize, then Skills.

Who is the skill generator for?

The skill generator is for anyone who repeats a job with an AI agent, and it works well with my other tools:

• AI prompt generator – for a one-off prompt when a job doesn't need a skill
• DESIGN.md generator – for a design file your agent follows when it builds pages
• AI slop checker – for checking the writing your skill helps produce

Your skill stays in your browser. Nothing you type is uploaded.