# Skill Creator

> Guide for creating effective skills. Use this skill when users need to create a new skill or reshape a draft skill package before hardening, benchmarking, or distribution.

- Skill: `jscraik/skill-creator-2` (Agent Skill, multi-file: 27 files)
- Install (CLI): `npx skillmds@latest add jscraik/skill-creator-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jscraik/skill-creator-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Finance & Business
- Author: jscraik (https://skillmd.com/u/jscraik)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jscraik/skill-creator-2

---


# Skill Creator

Use this skill to create or restructure a skill package so it is ready for hardening.

## When to use
- New skill creation from user intent.
- Major reshape of an existing draft skill.
- Packaging alignment across `SKILL.md`, `references/`, `scripts/`, and `agents/openai.yaml`.

## Do not use
- Release-hardening/evals: route to `[[skill-builder]]`.
- Install/import flows: route to `[[skill-installer]]`.

## Core Philosophy
- Start with a narrow, executable scope.
- Keep routing intent explicit in `SKILL.md`.
- Preserve required context by relocating detail to `references/`.

## Core workflow
1. Confirm goal, trigger phrases, and category.
2. Define smallest viable package boundary.
3. Create/update required files with canonical names.
4. Move deep details to references and keep `SKILL.md` route-focused.
5. Run baseline validation commands and report outcomes.

## Required output contract
Provide:
- `schema_version`
- `mode`
- `skill_path`
- `changed_files`
- `context_routes`
- `validation_evidence`
- `risks`

## Progressive disclosure policy
Never drop required context; relocate depth into `references/` with explicit signposts.

Read when:
- drafting structure and routing text: [foundations](./references/foundations.md)
- creating reusable handoff payloads: [handoff package template](./references/handoff-package-template.md)
- shaping examples and edge handling: [examples and gotchas](./references/examples-and-gotchas.md)

## Anti-Patterns to Avoid
- Building broad package scaffolds without a clear trigger surface.
- Duplicating long policy text in `SKILL.md` instead of references.
- Returning unvalidated scaffolds as production-ready outputs.

## Constraints
- Preserve user constraints exactly.
- Use deterministic, reproducible edits.
- Redact sensitive values in outputs.