> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentfacets.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Your First Facet

> Scaffold, author, build, and verify a facet

By the end of this guide you will have a working `.facet` file ready to publish or share. Make sure you have the CLI installed first  -- see [Setup & Prerequisites](/guides/setup).

> **Authoring a facet? Read the CLI's own agent instructions first.** The CLI
> is the single source of truth for the non-interactive authoring workflow:
>
> ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
> facet instructions authoring   # scaffold → modify → verify, headless
> facet instructions manifest    # facet.json structure + generated JSON Schema
> ```
>
> The short version:
>
> ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
> # 1. Scaffold headlessly (no wizard). A default README.md is written and
> #    declared unless you pass --no-readme:
> facet create my-facet \
>   --name my-facet --description "My first facet" \
>   --skill code-review --agent reviewer --command review-pr
>
> # 2. Write the asset files: skills/<name>/SKILL.md, agents/<name>.md,
> #    commands/<name>.md. Change the manifest with `facet modify`
> #    (e.g. descriptions, adapter config) instead of `facet edit`.
> facet modify skill code-review --description "Guidelines for reviewing code"
>
> # 3. Validate without producing an artifact, then build:
> facet build --verify
> facet build
> ```
>
> See [`facet instructions`](/cli/instructions), [`facet create`](/cli/authoring/create),
> [`facet modify`](/cli/authoring/modify), and [`facet build`](/cli/authoring/build).