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

# List Skills

> List all skills available to an instance.

Returns the skills available on an instance. By default this includes all skills — both installed and uninstalled. Use the `eligible_only` query parameter to filter down to just the ones that are ready to go.

## Authentication

Requires an **org-level API key** or a **scoped token** with the `configure` permission.

## Path Parameters

<ParamField path="instance_id" type="string" required>
  The ID of the instance.
</ParamField>

## Query Parameters

<ParamField query="eligible_only" type="boolean" default="false">
  When `true`, only returns skills that are fully installed and ready to use.
</ParamField>

## Response

Returns an array of skill objects.

<ResponseField name="skills" type="array">
  <Expandable title="Skill object">
    <ResponseField name="name" type="string">
      The skill's identifier.
    </ResponseField>

    <ResponseField name="description" type="string">
      A short description of what the skill does.
    </ResponseField>

    <ResponseField name="source" type="string">
      Where the skill was installed from (e.g. `clawhub`, `local`).
    </ResponseField>

    <ResponseField name="ready" type="boolean">
      Whether the skill is fully configured and ready to use.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  curl -X GET "https://api.chowder.dev/v1/instances/ins_abc123/skills?eligible_only=true" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  [
    {
      "name": "web-search",
      "description": "Search the web and return summarized results.",
      "source": "clawhub",
      "ready": true
    },
    {
      "name": "image-gen",
      "description": "Generate images from text prompts.",
      "source": "clawhub",
      "ready": true
    }
  ]
  ```
</ResponseExample>