> ## 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.

# Get Skill

> Get a skill by ID or name with full content

## Overview

Retrieves a skill with all its content including:

* **SKILL.md** - The main instructions file
* **Scripts** - Executable code files
* **References** - Additional documentation
* **Assets** - Templates and resources

## Path Parameters

<ParamField path="skill_id" type="string" required>
  The skill UUID or name (e.g., `pdf-processing`)
</ParamField>

## Response

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

<ResponseField name="name" type="string">
  Skill name
</ResponseField>

<ResponseField name="description" type="string">
  Skill description
</ResponseField>

<ResponseField name="skill_md" type="string">
  Full content of SKILL.md including YAML frontmatter
</ResponseField>

<ResponseField name="scripts" type="array">
  Array of script files

  <Expandable title="File object">
    <ResponseField name="name" type="string">
      Filename (e.g., `extract.py`)
    </ResponseField>

    <ResponseField name="content" type="string">
      File content
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="references" type="array">
  Array of reference files (same structure as scripts)
</ResponseField>

<ResponseField name="assets" type="array">
  Array of asset files (same structure as scripts)
</ResponseField>

<ResponseField name="license" type="string">
  License information
</ResponseField>

<ResponseField name="compatibility" type="string">
  Environment requirements
</ResponseField>

<ResponseField name="metadata" type="object">
  Additional metadata (author, version, etc.)
</ResponseField>

## Example

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.danubeai.com/v1/skills/pdf-processing"
  ```
</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.",
    "skill_md": "---\nname: pdf-processing\ndescription: Extract text from PDFs...\n---\n\n# PDF Processing\n\n## Instructions\n...",
    "scripts": [
      {
        "name": "extract.py",
        "content": "#!/usr/bin/env python3\nimport PyPDF2\n..."
      }
    ],
    "references": [
      {
        "name": "REFERENCE.md",
        "content": "# Detailed Reference\n\n## API Details\n..."
      }
    ],
    "assets": [
      {
        "name": "template.json",
        "content": "{ \"output_format\": \"text\" }"
      }
    ],
    "license": "Apache-2.0",
    "compatibility": null,
    "metadata": {
      "author": "example-org",
      "version": "1.0"
    },
    "service_id": null
  }
  ```
</ResponseExample>

## MCP Tool

This endpoint is also available as the `get_skill` MCP tool:

```python theme={null}
# Using the Danube MCP Server
result = await mcp.call_tool("get_skill", {
    "skill_id": "pdf-processing"
})

# Or by name
result = await mcp.call_tool("get_skill", {
    "skill_name": "pdf-processing"
})
```

## Using Skills

Once you retrieve a skill, the AI agent can:

1. Read the `skill_md` content for instructions
2. Execute scripts from the `scripts` array
3. Reference additional docs from `references`
4. Use templates from `assets`

The skill provides structured guidance that agents can follow to complete specialized tasks.