Skill creator
Skill nibzard/skills/skills/skill-creator/skills/skill-creator
Create new Agent Skills interactively or from templates. Use when user wants to create, generate, scaffold, or build a new skill, or mentions creating skills, writing skills, skill templates, skill development.From its SKILL.md
npx -y skills add nibzard/skills --skill skill-creatorAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
3 things to look at
- reads credentialsReads from 1 credential source: `API_KEY`.
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 2 commands, including `pip install requests pydantic` and 1 more.
SKILL.md
6.9 KB, ~1.5k tokens by cl100k_base, as published. Nobody here has run it
Skill Creator
Creates new Agent Skills through interactive wizard or template-based generation. A meta-skill for bootstrapping Claude Code capabilities.
When This Skill Activates
- User asks to "create a skill", "make a skill", "generate a skill", "scaffold a skill"
- User mentions "skill template", "new skill", "custom skill", "skill development"
- User wants to extend Claude with custom capabilities or workflows
- User asks about building, authoring, or writing skills
Workflow
Step 1: Choose Mode
Ask the user which mode they prefer:
- Interactive Wizard: Guided Q&A to build a skill from scratch
- Template-Based: Start from a pre-built template and customize
- Hybrid: Template foundation + interactive customization
Step 2: Gather Requirements (Interactive Mode)
Ask these questions in order:
- Skill Name: What should the skill be called? (kebab-case, max 64 chars)
- Purpose: What does this skill do? (one sentence)
- Trigger Phrases: When should Claude use this skill? (list 3-5 specific phrases users might say)
- Tool Permissions: Which tools does the skill need? (Read, Write, Edit, Bash, Grep, Glob - request minimal)
- Skill Type:
- Simple: Single SKILL.md only
- With Scripts: SKILL.md + Python/bash helper scripts
- With Reference: SKILL.md + reference.md for technical docs
- With Examples: SKILL.md + examples.md for use cases
- Complex: All of the above
- Target Location:
- Personal:
~/.claude/skills/(just for you) - Project:
.claude/skills/(shared with team) - Standalone: Portable plugin structure (for distribution)
- Personal:
Step 3: Select Template (Template Mode)
Available templates in templates/:
| Template | Purpose | Best For |
|---|---|---|
pr-reviewer | Review pull requests against standards | Teams with code review workflows |
commit-helper | Generate commit messages from diffs | Projects with commit conventions |
api-caller | Call external APIs with auth | Integrations with external services |
code-analyzer | Analyze code quality and patterns | Codebases needing quality checks |
data-processor | Process CSV/JSON data files | Data transformation workflows |
Step 4: Generate Core Files
Always generate:
-
SKILL.md - Complete with:
- YAML frontmatter (name, description, allowed-tools)
- When This Skill Activates section
- Main workflow/instructions
- Examples section
- Troubleshooting section
-
.claude-plugin/plugin.json - With:
- Skill name and version
- Description matching SKILL.md
- Author info (prompt for name/email)
- License (default: MIT)
-
README.md - With:
- Skill overview
- Installation instructions
- Quick start example
- Requirements
-
examples.md (if skill type includes it) - With:
- 2-3 complete usage examples
- Input/output samples
- Common scenarios
Conditionally generate:
- scripts/ directory for automation skills
- reference.md for technical/API skills
- templates/ for generator skills
Step 5: Validate Before Writing
Before creating files, validate:
- Name is kebab-case (lowercase letters, numbers, hyphens only)
- Name is <= 64 characters
- Description is <= 1024 characters
- Description includes specific trigger phrases
- Tool permissions are minimal (don't request tools the skill won't use)
- YAML frontmatter is valid (proper
---delimiters) - File paths use forward slashes
Step 6: Create Files
Use Write tool to create files in the selected location.
For target location = "standalone", create full plugin structure:
skill-name/
├── SKILL.md
├── .claude-plugin/
│ └── plugin.json
├── README.md
└── examples.md
Step 7: Verification
After creating files, tell the user:
- Where files were created
- How to verify the skill works:
What Skills are available?should list the new skill- Test with a query matching the description
- Next steps (edit SKILL.md to customize, test with example queries)
Template Details
pr-reviewer.md
Reviews pull requests against team standards. Checks for common issues, provides structured feedback format, integrates with git workflow.
commit-helper.md
Generates conventional commit messages from git diffs. Supports custom commit conventions, formats summaries and body, handles commit types.
api-caller.md
Integrates with external APIs. Handles authentication (API keys, OAuth), rate limiting, error responses, request/response parsing.
code-analyzer.md
Analyzes code quality. Detects anti-patterns, suggests improvements, generates quality reports, supports multiple languages.
data-processor.md
Processes data files (CSV, JSON, YAML). Validates schemas, transforms data, handles large files, generates outputs.
Best Practices for Generated Skills
Description Writing
- Start with "Use when..." for clarity
- Include 3-5 specific trigger scenarios
- Mention what makes this skill unique
- Keep under 1024 characters
Tool Permissions
- Request only necessary tools
- Use specific constraints (e.g.,
Bash(python:*)) - Explain why each tool is needed
Progressive Disclosure
- Keep SKILL.md focused (under 500 lines)
- Reference supporting files for deep details
- Don't duplicate content across files
Common Patterns
Skill with Scripts
When a skill needs helper scripts:
## Utility Scripts
This skill includes helper scripts for complex operations:
```bash
# Validate input
python scripts/validate.py input.txt
# Transform data
python scripts/transform.py input.csv output.json
### Skill with Reference
For technical/API skills, reference detailed docs:
```markdown
## Technical Reference
For complete API details, see [reference.md](reference.md).
Skill with Environment Variables
If the skill needs environment setup:
## Requirements
Set these environment variables:
- `API_KEY`: Your service API key
- `ENDPOINT`: API endpoint URL
Install dependencies:
```bash
pip install requests pydantic
## Troubleshooting
### Skill Not Appearing
- Verify SKILL.md path is correct
- Check YAML frontmatter is valid
- Run `claude --debug` to see loading errors
### Description Not Triggering
- Add more specific trigger phrases
- Include keywords users would naturally say
- Test with different query phrasings
### Validation Errors
- Check name is kebab-case only
- Verify description length < 1024 chars
- Ensure YAML has proper `---` delimiters
## Examples
See [examples.md](examples.md) for complete walkthroughs of creating skills in each mode.
What ships with it: 6 files
30.3 KB alongside SKILL.md
templates/
- api-caller.md5.1 KB
- code-analyzer.md4.6 KB
- commit-helper.md2.9 KB
- data-processor.md7.3 KB
- pr-reviewer.md3.0 KB
- examples.md7.4 KB
Gives 1 of the 12 instructions most skill authoring skills give in ~1.5k tokens
Counted across 408 of the 422 authors here whose files we hold, read 2026-09-06
- Keep SKILL.md under 500 lineshere, and in 118 of 408, across 104 files
- Write skill instructions in imperative formin 44 of 408, across 37 files
- Move detailed reference material into references filesin 41 of 408, across 34 files
- Run init_skill.py to initialize new skillsin 40 of 408, across 33 files
- Draft assertions while test runs are in progressin 32 of 408, across 25 files
- Keep description under 1024 charactersin 31 of 408, across 18 files
- Run package_skill.py once the skill is completein 29 of 408, across 23 files
- Spawn with-skill and baseline runs in the same turnin 28 of 408, across 21 files
- Test added scripts by actually running themin 27 of 408, across 21 files
- Follow the creation steps in orderin 24 of 408, across 17 files
- Generate the eval viewer before evaluating outputs yourselfin 24 of 408, across 17 files
- Write the description in third personin 24 of 408, across 18 files
Said here and by no other author read
- Gather requirements with ordered questions
- Generate plugin.json, README.md, and examples.md
- Validate name, description, and YAML before writing
- Request only minimal tool permissions
- Tell the user where files were created
- Explain how to verify the new skill works
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.