create-portable-skill

name	create-portable-skill
description	Create, audit, or package a portable Claude/Codex skill. Use when building a new skill, converting an existing workflow into a reusable skill, reviewing whether something is a real skill or just a rule/reference/kit, or preparing a skills repository catalog.

Create Portable Skill

Create skills that another agent can actually use. A skill is a packaged workflow, not a rule, essay, prompt dump, or product pitch.

1. Classify the candidate

Before writing files, decide what the artifact is:

Type	Definition	Destination
Packaged skill	Multi-step workflow, concrete output, portable dependencies	skills/<name>/
Draft skill	Real workflow but incomplete body, name, trigger, or bundled files	skills/<name>/ with explicit draft status
Kit	Installable system made of hooks, templates, multiple files, or multiple skills	kits/
Rule/pattern	Principle, invariant, hook pattern, or one-step guardrail	rules/ or docs, not skills/
Reference	Background methodology a skill can point to	reference/
Reject	Too vague, too local, not a workflow, no crisp trigger	Do not catalog

If it could be one bullet in a rules file, do not make it a skill.

2. Apply the skill bar

A packaged skill must pass all five:

1. Workflow: at least three ordered moves, or one staged judgment process with a clear start and end.