Usage
facet.json already exists in the target directory, the command prompts for confirmation before overwriting. Use --force to skip the prompt.
Wizard flow
- Name — the facet name, in kebab-case (e.g.,
my-facet). - Description — a brief description of the facet.
- Version — defaults to
0.0.0. - Assets — add skills, agents, and commands by name. At least one asset is required. Each asset shows its description below the name — press Enter to edit the name, or press ↓ during name editing to edit the description in your terminal editor.
- Confirmation — review the summary and confirm.
Generated files
On confirmation, the wizard writes:facet.json— the manifest with named asset descriptorsskills/<name>/SKILL.md— starter skill template (Agent Skills directory convention)agents/<name>.md— starter agent templatecommands/<name>.md— starter command template
facet edit to iterate on your facet, or facet build to validate and package it.
Options
| Flag | Description |
|---|---|
--force | Overwrite existing facet.json |
--help | Show help |
Exit codes
| Code | Meaning |
|---|---|
0 | Facet created successfully |
1 | Cancelled, declined overwrite, or invalid input |