Skills

List API Performance skills from the Sapient CLI.

Skills are reusable instructions or assets Sapient 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
sapient api-performance skills list	List available API Performance skills.

List skills

sapient api-performance skills list --output-format json

Filter by source or integration:

sapient api-performance skills list \
  --integration-id int_123 \
  --source-id source_123

Include disabled or stale skills:

sapient api-performance skills list \
  --enabled false \
  --stale true

Useful flags:

Flag	Description
--integration-id	Limit skills to one API Performance source integration.
--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:

{
  "data": [
    {
      "id": "skill_123",
      "source_id": "source_123",
      "integration_id": "int_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 sapient api-performance evals update --eval-id eval_123 --skills-mode '"selected"' --skill-ids '["skill_123"]'.