---
title: skill_list
description: List your organization's ad-ops playbooks (Skills) by slug, name, and description.
---

Lists the **Skills** (ad-ops playbooks) in your organization. Returns each Skill's `slug`, `name`, and `description` only — never the body. This is progressive disclosure: the agent picks the right Skill from its description, then loads the full instructions with [`skill_get`](/mcp/tools/skill-get).

## Input

None. The active organization is resolved from your OAuth token.

## Output

An array of `{ slug, name, description }`. Soft-deleted Skills are excluded.

## Example

> _"What ad-ops playbooks do I have?"_

```ts
skill_list();
// → [{ slug: 'weekly-meta-audit', name: 'Weekly Meta Audit', description: '…' }, …]
```

:::info[Slug is the handle]

The `slug` is the stable per-organization handle you pass to [`skill_get`](/mcp/tools/skill-get), [`skill_update`](/mcp/tools/skill-update), and [`skill_delete`](/mcp/tools/skill-delete). Bodies are intentionally omitted here — fetch them on demand.

:::

## Errors

- `401` or `403` — see [Errors](/mcp/errors), which every tool shares. This one needs `skill:read`.