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 identity. Either an unscoped name (
my-facet) or a scoped name (@scope/name, e.g.@acme/my-facet). See the Manifest Schema for the full name grammar. - Description — a brief description of the facet.
- Version — defaults to
0.0.0. - Privacy — choose Public (the default) or Private.
- Assets — add skills, agents, and commands by name.
- 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
name, description, and any per-adapter extras are merged on top of whatever the author wrote.
After creating the project, use 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 |