Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a claude-code
Open on GitHub

What 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/ and references/
  • 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.md with 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-code

2Manually: put the files in place

~/.claude/skills/skill-creator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill-creator/

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.

skill-creator official anthropics skill-creator is a Claude Code skill that creates and refines skills, then tests them with prompts, evaluations, and performance checks. CX Codex +1 414,180installs skill-creator openclaw skill-creator is a Claude Code skill that helps author, validate, and restructure SKILL.md files and resources when creating a skill or revising an existing one. CX Codex +1 6,700installs skill-creator official openai skill-creator is a Claude Code skill for creating and updating agent skills, organizing procedures, scripts, and documentation while keeping token overhead low. CX Codex +1 5,300installs skill-creator sickn33 skill-creator is a Claude Code skill for drafting and reviewing reusable skills. It supports skill authoring and packaging tasks. CX Codex +1 988installs skill-creator himself65 skill-creator — a skill that walks you through creating a new agent skill, fixing one that misbehaves, or scoring it against a rubric. Useful when a manual routine should become repeatable. CX Codex +1 3,300installs ppt-template-creator official anthropics ppt-template-creator — a skill for Claude Code and five other platforms that wraps a PowerPoint template file into a reusable skill with layout maps and content boundaries. CX Codex +1 2,400installs gem-skill-creator official github gem-skill-creator is a GitHub Copilot subagent that packages verified workflow patterns as portable Agent Skills. It runs when a reusable process needs a SKILL.md. CX Codex +1 ★ 41,430repo stars huawei-cloud-skill-creator huaweicloud huawei-cloud-skill-creator — a Claude Code skill that turns an idea into a finished Huawei Cloud skill through six chained phases. CX Codex +1 643installs article-prompts-to-skills MengTo article-prompts-to-skills is a Claude Code skill that turns articles, tutorials, and prompt packs into reusable AgentSkills. CX Codex +1 1,600installs skill-from-github GBSOSS skill-from-github searches GitHub for mature projects that solve your task, studies how they work, and turns that knowledge into a new skill. CX Codex +1 481installs prd-creator pageai The prd-creator skill turns a rough app idea into a PRD with verifiable pass criteria, then breaks it into JSON tasks. Useful when a feature needs writing down before code starts. CX Codex +1 5,600installs

From the same set20

The whole set →
playwright Skill for writing E2E tests on Playwright using the Page Objects pattern. Guides you through exploring real UI with MCP tools first, then writing selectors and assertions based on actual page structure. CX Codex +1 194installs elixir-antipatterns elixir-antipatterns is a Claude Code skill that guides code reviews, Ecto query tuning, and Phoenix refactoring with a catalog of 8 anti-patterns. CX Codex +1 194installs nextjs-15 Supplies Next.js 15 App Router patterns covering file conventions, Server Actions, parallel data fetching, and middleware. CX Codex +1 185installs electron Guides desktop app development in Electron with secure IPC patterns, typed channels, and clear separation between main and renderer processes. CX Codex +1 175installs django-drf django-drf is a Claude Code skill with patterns for Django REST APIs: ViewSets, serializers, filters, permissions, and tests. The patterns cover starting or extending an API. CX Codex +1 162installs angular-forms A skill for building Angular forms: covers Signal Forms (experimental, Angular 21+) and production-ready Reactive Forms. Activates when you work with form validation, state management, or form creation. CX Codex +1 150installs spring-boot-3 Rules an AI agent follows when it writes or refactors a Spring Boot 3 service: configuration, dependency injection and the web layer. CX Codex +1 143installs ai-sdk-5 Guides code generation for Vercel AI SDK 5, covering breaking syntax shifts from v4. CX Codex +1 138installs

Project sponsors

Companies that keep this analytics open