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

# Agent Skills

> What an AI agent can do with Closient — a discoverable, version-pinned set of skills published at /.well-known/agent-skills/.

Closient publishes a set of **Agent Skills** — short, focused capability
descriptions that an AI agent can fetch to learn how to drive a specific
Closient workflow. Each skill is a markdown document covering when to use it,
which endpoint backs it, the inputs it requires, what the response looks like,
and which related skills round out the workflow.

Skills are discoverable at `/.well-known/agent-skills/` per the
[Agent Skills v0.2.0 specification](https://agentskills.io/). The
[index document](https://www.closient.com/.well-known/agent-skills/index.json)
lists every skill with its content hash so agents can cache safely.

The pages below render the same source content in a human-friendly form.
They are the canonical reference for **what Closient can be asked to do** —
useful for product managers scoping integrations, developers picking an
endpoint, and brand owners deciding what to expose.

## Consumer skills

Skills aimed at the everyday consumer-facing flow: find a product, see if it
is nearby, see whether it has been recalled, suggest an alternative if it has.

<CardGroup cols={2}>
  <Card title="Local Product Search" icon="magnifying-glass" href="/agent-skills/local-product-search">
    Find products available at nearby physical retail stores, ranked by
    proximity and inventory confidence.
  </Card>

  <Card title="Hyperlocal Nearby" icon="location-dot" href="/agent-skills/hyperlocal-nearby">
    Surface the closest stores carrying a known product within a tight
    walking-or-cycling radius.
  </Card>

  <Card title="Check Product Availability" icon="store" href="/agent-skills/check-product-availability">
    Confirm whether a specific GTIN is in stock at nearby stores right now.
  </Card>

  <Card title="Check Recalls" icon="triangle-exclamation" href="/agent-skills/check-recalls">
    Look up active recalls and safety notices for a product, optionally
    narrowed to a batch/lot.
  </Card>

  <Card title="Find Alternative" icon="shuffle" href="/agent-skills/find-alternative">
    Recommend an alternative product when the requested one is unavailable,
    unsuitable, or recalled.
  </Card>

  <Card title="Compare Products" icon="scale-balanced" href="/agent-skills/compare-products">
    Compare two or more products on certifications, allergens, substances,
    claims, and price.
  </Card>

  <Card title="Plan Shopping Trip" icon="cart-shopping" href="/agent-skills/plan-shopping-trip">
    Plan a single shopping trip that collects everything on a list from the
    fewest nearby stores.
  </Card>

  <Card title="Dietary Filter Search" icon="leaf" href="/agent-skills/dietary-filter-search">
    Search with allergen, certification, and dietary-restriction constraints
    enforced at the result level.
  </Card>
</CardGroup>

## Identifier skills

Skills that resolve, decode, or look up structured identifiers — GS1 GTINs,
serials, batch/lot codes — back to product information.

<CardGroup cols={2}>
  <Card title="Resolve GTIN" icon="barcode" href="/agent-skills/resolve-gtin">
    Resolve a GS1 Digital Link URL or bare GTIN to structured product detail,
    with optional AI 10 / AI 21 qualifiers.
  </Card>
</CardGroup>

## Brand-owner skills

Skills scoped to a brand-owner persona — these power the dashboards a brand
sees when they ask "what are agents doing with my products?"

<CardGroup cols={2}>
  <Card title="Brand Scan Summary" icon="chart-line" href="/agent-skills/brand-scan-summary">
    Summarize scan activity for a brand's products: where, when, how often,
    which lots.
  </Card>

  <Card title="Brand Search Demand" icon="magnifying-glass-chart" href="/agent-skills/brand-search-demand">
    Show where demand for a brand's products is coming from — queries, regions,
    competitive comparisons.
  </Card>

  <Card title="Brand Retail Footprint" icon="map" href="/agent-skills/brand-retail-footprint">
    Where a brand's products are actually being carried in physical retail,
    not just where they list distribution.
  </Card>
</CardGroup>

## How to consume these as an agent

```http theme={null}
GET /.well-known/agent-skills/index.json
```

Returns the canonical index with content hashes. Fetch any individual skill at
`/.well-known/agent-skills/{slug}.md` and treat the markdown as your
instructions for that capability.

Agents that prefer a richer discovery surface should also pull the
[Agent Card](/.well-known/agent.json) and the
[MCP descriptor](/.well-known/mcp.json) — both link to the same skills index.