skill-creator · gentleman-programming — Claude Code skill: create skills, install
skill-creator builds new AI agent skills against the Agent Skills spec. Use it for recurring patterns, project rules, and workflows that need explicit steps.
Apache-2.0 171 installs ★ 678 updated 2026-03-28
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a claude-codeWhat skill-creator does
This skill guides the creation of a new agent skill. It helps decide when a reusable pattern deserves its own skill, then lays out skills/{skill-name}/ with the required SKILL.md and optional assets/ and references/ directories. The file template covers frontmatter, usage conditions, critical patterns, focused examples, commands, and resources.
It also explains when to place templates, schemas, or sample configs in assets/, and when to point from references/ to local documentation. Afterward, the new entry belongs in AGENTS.md; the checklist covers naming, triggers, examples, and required sections. The prowler-* naming rules and Apache-2.0 requirement are tied to Prowler, so they need review in another project.
The skill allows Read, Edit, Write, Glob, Grep, Bash, WebFetch, WebSearch, and Task. It is aimed at reusable guidance, not a one-off task or a self-explanatory pattern.
What it helps with
- create a reusable agent skill
- define triggers and critical agent rules
- choose between
assets/andreferences/ - register a skill in
AGENTS.md - check frontmatter before writing the skill
Example prompts for the agent
- Create a skill for our recurring API workflow and add it to
AGENTS.md. - Draft
SKILL.mdwith frontmatter, critical patterns, focused code examples, and a Commands section. - Decide whether this pattern needs a new skill or a reference to existing documentation.
How to install skill-creator
1Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a claude-code2Manually: put the files in place
~/.claude/skills/skill-creator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-creator/
1Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a codex2Manually: put the files in place
.agents/skills/skill-creator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a cursor2Manually: put the files in place
.cursor/skills/skill-creator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Gentleman-Programming/Gentleman-Skills curated/skill-creator/SKILL.md2Manually: put the files in place
.github/skills/skill-creator/SKILL.md1Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a gemini-cli2Platform CLI
gemini skills install https://github.com/Gentleman-Programming/Gentleman-Skills --path curated/skill-creatorManually: put the files in place
.devin/skills/skill-creator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-creator
How do I install skill-creator in Claude Code?
Run npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a claude-code, then check ~/.claude/skills/skill-creator/SKILL.md.
What does skill-creator do?
It structures new Agent Skills by covering the directory layout, SKILL.md content, optional resources, naming, and registration in AGENTS.md.
What belongs in assets/ versus references/?
Use assets/ for templates, JSON schemas, and sample configs. Use references/ for links to local documentation rather than web pages.
Source text
SKILL.md · Apache-2.0
---
name: skill-creator
description: >
Creates new AI agent skills following the Agent Skills spec.
Trigger: When user asks to create a new skill, add agent instructions, or document patterns for AI.
license: Apache-2.0
metadata:
author: gentleman-programming
version: "1.0"
allowed-tools: Read, Edit, Write, Glob, Grep, Bash, WebFetch, WebSearch, Task
---
## When to Create a Skill
Create a skill when:
- A pattern is used repeatedly and AI needs guidance
- Project-specific conventions differ from generic best practices
- Complex workflows need step-by-step instructions
- Decision trees help AI choose the right approach
**Don't create a skill when:**
- Documentation already exists (create a reference instead)
- Pattern is trivial or self-explanatory
- It's a one-off task
---
## Skill Structure
```
skills/{skill-name}/
├── SKILL.md # Required - main skill file
├── assets/ # Optional - templates, schemas, examples
│ ├── template.py
│ └── schema.json
└── references/ # Optional - links to local docs
└── docs.md # Points to docs/developer-guide/*.mdx
```
---
## SKILL.md Template
```markdown
---
name: {skill-name}
description: >
{One-line description of what this skill does}.
Trigger: {When the AI should load this skill}.
license: Apache-2.0
metadata:
author: gentleman-programming
version: "1.0"
---
## When to Use
{Bullet points of when to use this skill}
## Critical Patterns
{The most important rules - what AI MUST know}
## Code Examples
{Minimal, focused examples}
## Commands
```bash
{Common commands}
```
## Resources
- **Templates**: See [assets/](assets/) for {description}
- **Documentation**: See [references/](references/) for local docs
```
---
## Naming Conventions
| Type | Pattern | Examples |
|------|---------|----------|
| Generic skill | `{technology}` | `pytest`, `playwright`, `typescript` |
| Prowler-specific | `prowler-{component}` | `prowler-api`, `prowler-ui`, `prowler-sdk-check` |
| Testing skill | `prowler-test-{component}` | `prowler-test-sdk`, `prowler-test-api` |
| Workflow skill | `{action}-{target}` | `skill-creator`, `jira-task` |
---
## Decision: assets/ vs references/
```
Need code templates? → assets/
Need JSON schemas? → assets/
Need example configs? → assets/
Link to existing docs? → references/
Link to external guides? → references/ (with local path)
```
**Key Rule**: `references/` should point to LOCAL files (`docs/developer-guide/*.mdx`), not web URLs.
---
## Decision: Prowler-Specific vs Generic
```
Patterns apply to ANY project? → Generic skill (e.g., pytest, typescript)
Patterns are Prowler-specific? → prowler-{name} skill
Generic skill needs Prowler info? → Add references/ pointing to Prowler docs
```
---
## Frontmatter Fields
| Field | Required | Description |
|-------|----------|-------------|
| `name` | Yes | Skill identifier (lowercase, hyphens) |
| `description` | Yes | What + Trigger in one block |
| `license` | Yes | Always `Apache-2.0` for Prowler |
| `metadata.author` | Yes | `gentleman-programming` |
| `metadata.version` | Yes | Semantic version as string |
---
## Content Guidelines
### DO
- Start with the most critical patterns
- Use tables for decision trees
- Keep code examples minimal and focused
- Include Commands section with copy-paste commands
### DON'T
- Add Keywords section (agent searches frontmatter, not body)
- Duplicate content from existing docs (reference instead)
- Include lengthy explanations (link to docs)
- Add troubleshooting sections (keep focused)
- Use web URLs in references (use local paths)
---
## Registering the Skill
After creating the skill, add it to `AGENTS.md`:
```markdown
| `{skill-name}` | {Description} | [SKILL.md](skills/{skill-name}/SKILL.md) |
```
---
## Checklist Before Creating
- [ ] Skill doesn't already exist (check `skills/`)
- [ ] Pattern is reusable (not one-off)
- [ ] Name follows conventions
- [ ] Frontmatter is complete (description includes trigger keywords)
- [ ] Critical patterns are clear
- [ ] Code examples are minimal
- [ ] Commands section exists
- [ ] Added to AGENTS.md
## Resources
- **Templates**: See [assets/](assets/) for SKILL.md template
© gentleman-programming · Apache-2.0 · Gentleman-Programming/Gentleman-Skills
Similar skills
All skills for Agent setup: memory, context, orchestration →skill-creator by other authors comes first.