aiskillstore/marketplace / skills/89jobrien/skill-creator
skill-creator
VerifiedGuide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
| File | Kind | Size |
|---|---|---|
| LICENSE.txt | markdown | 11.1 KB |
| SKILL.md | skill md | 11.6 KB |
| references/SUBAGENT.template.md | markdown | 2.0 KB |
| references/agent-skill.template.md | markdown | 2.6 KB |
| scripts/init-skill.pyexecutable | script | 10.6 KB |
| scripts/package-skill.pyexecutable | script | 3.2 KB |
| scripts/quick-validate.pyexecutable | script | 2.2 KB |
| skill-report.json | config | 39.0 KB |
references/agent-skill.template.md
View on GitHub---
author: Joseph OBrien
status: unpublished
updated: '2025-12-23'
version: 1.0.1
tag: skill
type: reference
parent: skill-creator
---
---
name: {{SKILL_NAME}}
description: {{SKILL_DESCRIPTION}}
---
# {{Skill Title}}
{{BRIEF_OVERVIEW}}
## When to Use This Skill
- {{USE_CASE_1}}
- {{USE_CASE_2}}
- {{USE_CASE_3}}
## What This Skill Does
1. {{CAPABILITY_1}}
2. {{CAPABILITY_2}}
3. {{CAPABILITY_3}}
## Core Principles
### Principle 1: {{PRINCIPLE_NAME}}
{{PRINCIPLE_EXPLANATION}}
### Principle 2: {{PRINCIPLE_NAME}}
{{PRINCIPLE_EXPLANATION}}
## Workflow
### Step 1: {{STEP_NAME}}
{{STEP_INSTRUCTIONS}}
### Step 2: {{STEP_NAME}}
{{STEP_INSTRUCTIONS}}
## Best Practices
- {{BEST_PRACTICE_1}}
- {{BEST_PRACTICE_2}}
## Anti-Patterns
- {{ANTI_PATTERN_1}}
- {{ANTI_PATTERN_2}}
## Examples
### Example 1: {{EXAMPLE_NAME}}
**Scenario:** {{SCENARIO_DESCRIPTION}}
**Approach:**
```
{{EXAMPLE_APPROACH}}
```
## Reference Files
This skill includes reference files in `references/`:
- `{{REFERENCE_FILE}}.md`: {{REFERENCE_DESCRIPTION}}
---
## Template Reference
### Required Structure
```
skill-name/
├── SKILL.md (required)
│ ├── YAML frontmatter (name, description)
│ └── Markdown body
└── Bundled Resources (optional)
├── scripts/ - Executable code
├── references/ - Documentation
└── assets/ - Output files
```
### Frontmatter Fields
| Field | Required | Description |
|-------|----------|-------------|
| `name` | Yes | Unique kebab-case identifier |
| `description` | Yes | Third-person description: "This skill should be used when..." |
### Body Structure Requirements
1. **When to Use** - Clear trigger conditions
2. **What This Skill Does** - Capabilities list
3. **Core Principles** - Domain frameworks (non-obvious knowledge)
4. **Workflow** - Step-by-step process
5. **Best Practices** - Do's
6. **Anti-Patterns** - Don'ts
7. **Examples** - Concrete usage scenarios
### Progressive Disclosure Design
| Level | Content | Size Guidance |
|-------|---------|---------------|
| Metadata | name + description | ~100 words |
| SKILL.md body | Core workflow | <5k words |
| References | Detailed knowledge | Unlimited |
### Quality Checklist
- [ ] Description uses third-person ("This skill should be used when...")
- [ ] Knowledge is non-obvious (not inherent to Claude)
- [ ] Workflow is actionable with clear steps
- [ ] Examples are concrete and domain-specific
- [ ] Anti-patterns help avoid common mistakes
- [ ] Large content moved to references/ (keeps SKILL.md lean)
- [ ] No placeholder text remains
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |