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

# Skills

> List API Performance skills from the Lightsage CLI.

Skills are reusable instructions or assets Lightsage can attach to API Performance evals. Use skills to give coding-agent runs additional context for SDK usage, framework setup, documentation conventions, or other repeatable implementation guidance.

## Command

| Command                                 | Description                            |
| --------------------------------------- | -------------------------------------- |
| `lightsage api-performance skills list` | List available API Performance skills. |

## List skills

```bash theme={null}
lightsage api-performance skills list --output-format json
```

Filter by API Performance source or skill source:

```bash theme={null}
lightsage api-performance skills list \
  --source-id source_123 \
  --skill-source-id skill_source_123
```

Include disabled or stale skills:

```bash theme={null}
lightsage api-performance skills list \
  --enabled false \
  --stale true
```

Useful flags:

| Flag                | Description                                  |
| ------------------- | -------------------------------------------- |
| `--source-id`       | Limit skills to one API Performance source.  |
| `--skill-source-id` | Limit skills to one skill source.            |
| `--enabled`         | Filter by enabled state. Defaults to `true`. |
| `--stale`           | Filter by stale state. Defaults to `false`.  |

Example response:

```json theme={null}
{
  "data": [
    {
      "id": "skill_123",
      "skill_source_id": "skill_source_123",
      "source_id": "source_123",
      "slug": "docs-helper",
      "name": "Docs helper",
      "description": "Use the product docs when writing integration code.",
      "path": "skills/docs-helper/SKILL.md",
      "entrypoint_path": "skills/docs-helper/SKILL.md",
      "content_hash": "sha256:abc123",
      "enabled": true,
      "stale": false,
      "metadata": {}
    }
  ],
  "meta": {
    "count": 1
  }
}
```

Use skill IDs with `lightsage api-performance evals update --eval-id eval_123 --skills-mode '"selected"' --skill-ids '["skill_123"]'`.