---
title: "Get details for one skill"
method: GET
path: "/agent/skills/{skillId}"
tags: ["Skills"]
---

# Get details for one skill

`GET /agent/skills/{skillId}`

## Path parameters

- `skillId` string, required

## Response `200`

Full skill metadata

- SkillDetail
  - `id` string, required — Stable identifier, e.g. `"pdf-summarize-v1"`.
  - `name` string, required — Human-readable display name.
  - `description` string, required
  - `tags` string[]
  - `version` string
  - `inputModes` string[]
  - `outputModes` string[]
  - `inputSchema` object — JSON-Schema for expected `message.parts`.
  - `outputSchema` object — JSON-Schema describing artifacts this skill produces.
  - `examples` object[]
    - `input` object
    - `output` object

## Other responses

- `404` — SkillNotFound

## Changes

- **2026-04-21** `8a22dc180044` — 5 breaking, 15 warning, 3 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - the response property `error` became optional for the status `404`
  - removed the required property `id` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - …19 more
- **2026-02-12** `970d68a5c55d` — 2 warning, 13 info
  - removed the optional property `inputSchema` from the response with the `200` status
  - removed the optional property `outputSchema` from the response with the `200` status
  - added the optional property `allowed_tools` to the response with the `200` status
  - added the optional property `assessment` to the response with the `200` status
  - …11 more

[Change history](https://skmtc.dev/getbindu/apis/bindu-agent-api/changes/agent/skills/:skillId/get.md)

---

[API](https://skmtc.dev/getbindu/apis/bindu-agent-api.md) · [All operations](https://skmtc.dev/getbindu/apis/bindu-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbindu/bindu-agent-api/revisions/e070faa5425b/schema)