---
title: "List agent skills"
method: GET
path: "/api/skills"
tags: ["Configuration"]
---

# List agent skills

`GET /api/skills`

## Request

- Base URL: `/api/plugins/consensys-asko11y-app/resources` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/plugins/consensys-asko11y-app/resources/api/skills`
- Auth: one of:
  - API key in cookie `grafana_session`
  - HTTP bearer

Returns metadata for skills without their bodies, feeding the chat slash commands and the AppConfig Skills tab. Hidden skills are excluded from this listing — they are never offered to users or the model. Admins may pass ?include=content to receive every skill (hidden included) with its SKILL.md source for the editor. Skill content is authored through the Grafana plugin admin API (jsonData.skills.entries), not through this endpoint.

## Response `200`

Skill listing

- SkillListResponse
  - `skills` SkillInfo[], required
    - `name` string, required
    - `description` string, required
    - `source` 'bundled' | 'custom', required: bundled skills ship in the plugin binary; custom skills are admin-authored
    - `customized` boolean, required: A bundled skill whose SKILL.md was overridden by an admin entry
    - `enabled` boolean, required
    - `hidden` boolean, required: Hidden skills are excluded from non-admin listings and never offered to users or the model; visible only in the Admin ?include=content management listing
    - `model` 'base' | 'large': Model preference when this skill is active
    - `maxIterations` integer: Iteration budget when this skill is active
    - `triggers` string: Case-insensitive regex that auto-activates the skill on match
    - `version` string
    - `hasUserPrompt` boolean, required
    - `invalid` boolean: The admin entry failed validation and is not active
    - `invalidReason` string

## Other responses

- `405`: Method not allowed (only GET is supported)

## Changes

- **2026-09-07** `68d0f5cf753e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/changes/api/skills/get.md)

---

[API](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api.md) - [All operations](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/revisions/ee3ccd0f186d?raw)