> ## Documentation Index
> Fetch the complete documentation index at: https://docs.danubeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List My Skills

> List the skills you own, optionally filtered by visibility

## Overview

Returns every skill owned by the signed-in user, newest first. Private and public skills are both included unless you filter by `visibility`.

**Auth:** Requires JWT token (`Authorization: Bearer <token>`). An API key is not accepted on this endpoint.

The Python and TypeScript SDKs do not wrap this endpoint yet, and there is no MCP tool for it. Call it directly.

## Query Parameters

<ParamField query="visibility" type="string">
  Filter by visibility. Options: `public`, `private`. Any other value returns `400`.
</ParamField>

## Response

Returns an array of skill summary objects.

<ResponseField name="id" type="string">
  Unique identifier for the skill
</ResponseField>

<ResponseField name="name" type="string">
  Skill name (lowercase, hyphens, 1-64 characters)
</ResponseField>

<ResponseField name="description" type="string">
  What the skill does and when to use it
</ResponseField>

<ResponseField name="license" type="string">
  License (e.g., "Apache-2.0")
</ResponseField>

<ResponseField name="compatibility" type="string">
  Environment requirements. This listing does not load the value, so it is always `null` here. Get Skill returns it.
</ResponseField>

<ResponseField name="metadata" type="object">
  Additional metadata from the SKILL.md frontmatter (author, version, etc.)
</ResponseField>

<ResponseField name="service_id" type="string">
  Optional linked service ID
</ResponseField>

<ResponseField name="visibility" type="string">
  `private` or `public`
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp
</ResponseField>

## Example

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.danubeai.com/v1/skills/my?visibility=private" \
    -H "Authorization: Bearer YOUR_JWT_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "pdf-processing",
      "description": "Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files.",
      "license": "Apache-2.0",
      "compatibility": null,
      "metadata": {
        "author": "example-org",
        "version": "1.0"
      },
      "service_id": null,
      "visibility": "private",
      "created_at": "2026-09-01T12:00:00Z"
    }
  ]
  ```
</ResponseExample>