Scaffold a new skill with SKILL.md and shipables.json templates.
shipables init
Create a new skill in the current directory with all the required files.
Usage
shipables init
This command is interactive — it prompts you for details about your skill and generates the necessary files.
What it creates
| File | Purpose |
|---|---|
SKILL.md | Agent instructions with YAML frontmatter |
shipables.json | Package manifest (version, categories, MCP config, etc.) |
README.md | Human-readable readme with install instructions |
.shipablesignore | Files to exclude from the published tarball |
scripts/ | Example scripts directory (optional) |
references/ | Example reference docs directory (optional) |
Prompts
The init wizard asks for:
| Prompt | Description |
|---|---|
| Skill name | Lowercase letters, numbers, hyphens. Max 64 characters. |
| Description | What the skill does and when to use it. |
| Author name | Your name. |
| Author GitHub | Your GitHub username. |
| License | Open source license (default: MIT). |
| Categories | Select from: databases, apis, testing, devops, security, documentation, code-quality, frameworks, cloud, ai-ml, data, messaging, monitoring, authentication, other. |