Skill Creator
Create or improve codewhale skills.
Install
npx skills add codewhale-hq/Codewhale --skill skill-creator -g -a claude-code -y- Repository
- codewhale-hq/Codewhale41.2k
- Category
- AI and agents
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 958 tokens
- Runs scripts
- No, instructions only
What it does
Create or improve codewhale skills. Use when the user wants a new skill, wants to update an existing skill, or needs guidance on when a skill should be a skill versus MCP, hooks, tools, or a plugin scaffold.
Skill Creator
Use this skill to create small, useful codewhale skills that match the runtime this repository actually ships.
What A Skill Is
A skill is a local folder with a SKILL.md file. Codewhale reads the skill name
and description during discovery, then loads the body only when the user or task
matches the skill.
Discovery paths, in precedence order:
<workspace>/.agents/skills<workspace>/skills<workspace>/.opencode/skills<workspace>/.claude/skills<workspace>/.cursor/skills<workspace>/.codewhale/skills~/.agents/skills~/.claude/skills~/.codewhale/skills
Use skills for model instructions, workflows, and lightweight conventions. Use
MCP for live external APIs or durable tools. Use hooks for automatic local
events. To distribute a skill through a plugin bundle, give the bundle a
plugin.json whose net.codewhale extension points skills.path at a
directory holding <name>/SKILL.md folders; each skill then loads namespaced
as <plugin>:<skill> after review, trust, and enablement. A bare SKILL.md
directory is discoverable on the skills paths above but is not a plugin
bundle and cannot be installed through /plugin install.
Minimum Shape
my-skill/
`-- SKILL.md
---
name: my-skill
description: Use when Codewhale should follow this specific workflow.
---
# My Skill
Instructions for the agent.
Frontmatter parsing is intentionally simple. Keep name and description as
plain single-line values. Use lower-case hyphen-case names.
