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

# Agent Skills

> Install 9Pic skills for Cursor, Claude Code, Codex, and other coding agents

## Overview

Agent Skills are short instruction files your coding agent loads while it writes a 9Pic integration. Install them into Cursor, Claude Code, Codex, or any other tool that supports the skills CLI.

Each skill names the [API Reference](/api-reference) pages for that job. The API key stays on your backend, FaceFind searches reuse one `request_id`, and guests see watermarked previews until you unlock originals.

<CardGroup cols={2}>
  <Card title="API Skill" icon="code" href="/agent-skills/9pic-api">
    API keys, identifiers, the response envelope, pagination, and errors.
  </Card>

  <Card title="Participant App" icon="images" href="/agent-skills/9pic-client">
    FaceFind, BibTrack, gallery, Motion clips, and watermarked previews.
  </Card>

  <Card title="Media Selling" icon="cart-shopping" href="/agent-skills/9pic-media-sell">
    Your checkout, then original photos after a confirmed sale.
  </Card>
</CardGroup>

## Install

<Steps>
  <Step title="Create an API key">
    Create a token in [Developer Zone](/dashboard-guide/developer-zone). Developer Zone is **Enterprise** only. Send the key as `X-API-Key` as described in [Authentication](/api-reference/authentication).
  </Step>

  <Step title="Install the skills">
    From the repository where the agent will write code:

    ```bash theme={null}
    npx skills add https://docs.9pic.ai
    ```

    That installs every 9Pic skill. To install one:

    ```bash theme={null}
    npx skills add https://docs.9pic.ai --skill 9pic-api
    npx skills add https://docs.9pic.ai --skill 9pic-client
    npx skills add https://docs.9pic.ai --skill 9pic-media-sell
    ```
  </Step>

  <Step title="Describe the integration">
    Tell the agent what you are building: a guest gallery, selfie search, bib search, clips, or paid originals. Paths, fields, and examples come from the linked API Reference pages.
  </Step>
</Steps>

<Note>
  Installed skills do not update on their own. After we publish a change, run `npx skills update -y` or re-run the add command.
</Note>

<Tip>
  If the `npx skills` CLI is not available, the discovery index is at `https://docs.9pic.ai/.well-known/skills/index.json`.
</Tip>

Agents that fetch [9pic.ai/llms.txt](https://9pic.ai/llms.txt) get a short product brief and the same install command. The [install guide](https://9pic.ai/blog/9pic-agent-skills/) walks through the CLI.

<Warning>
  Treat the API key as a server secret. Send `X-API-Key` only from your backend. Do not put the token in client-side code, a mobile binary, or a public repository.
</Warning>

## Common Questions

<AccordionGroup>
  <Accordion title="Which skill should I install?">
    Install all three if you are unsure. Use [API Skill](/agent-skills/9pic-api) for any call to `api.9pic.ai`. Add [Participant App](/agent-skills/9pic-client) for a guest-facing gallery or search. Add [Media Selling](/agent-skills/9pic-media-sell) when you take payment yourself and then unlock originals.
  </Accordion>

  <Accordion title="Do I still need the API Reference?">
    Yes. Paths, request bodies, pagination limits, and response shapes live in the [API Reference](/api-reference). Skills point the agent at those pages.
  </Accordion>

  <Accordion title="Can I sell photos through my own checkout?">
    Yes. Guests see thumbnails and watermarked images until you record a successful sale. Your backend then calls [Download Originals](/api-reference/download-original-photos). See [Media Selling](/agent-skills/9pic-media-sell).
  </Accordion>

  <Accordion title="Does this cover import, process, or go-live?">
    No. Those are organiser pipeline endpoints. Start from [Memories](/api-reference/memories) if you need them.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Create a token and send `X-API-Key`.
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference">
    Endpoints, conventions, models, and errors.
  </Card>

  <Card title="Developer Zone" icon="code" href="/dashboard-guide/developer-zone">
    Where Enterprise organisations create API keys.
  </Card>

  <Card title="Conventions" icon="compass" href="/api-reference/conventions">
    Base URL, identifiers, envelope, and pagination.
  </Card>
</CardGroup>