Usage
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.
Exit codes
| Code | Meaning |
|---|---|
0 | Facet created successfully |
1 | Cancelled or invalid input |