Skip to content

aiskillstore/marketplace / skills/89jobrien/skill-creator

skill-creator

Verified

Guide 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.

FileKindSize
LICENSE.txtmarkdown11.1 KB
SKILL.mdskill md11.6 KB
references/SUBAGENT.template.mdmarkdown2.0 KB
references/agent-skill.template.mdmarkdown2.6 KB
scripts/init-skill.pyexecutablescript10.6 KB
scripts/package-skill.pyexecutablescript3.2 KB
scripts/quick-validate.pyexecutablescript2.2 KB
skill-report.jsonconfig39.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
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall