skill_list

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.

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?”

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

Slug is the handle

The slug is the stable per-organization handle you pass to skill_get, skill_update, and skill_delete. Bodies are intentionally omitted here — fetch them on demand.

Errors

  • 401 Unauthorized — the OAuth token has expired. Re-authorize from your AI client’s settings.
  • 403 insufficient_scope — the token lacks the skill:read scope. Re-authorize and grant skill access.