Download Skill Files

GET /v1/:slug/download

Returns all skill documentation files (SKILL.md and endpoint docs) for an integration. Used by the CLI’s pull command to download docs for offline agent access.

Authentication

Required. Bearer token: Authorization: Bearer sk_xxx

Path parameters

Parameter	Type	Required	Description
slug	string	Yes	Integration slug (e.g., github)

Response

{
  "slug": "github",
  "files": [
    {
      "file_path": "SKILL.md",
      "content": "---\nname: skillett-github\nversion: 1.0.0\n..."
    },
    {
      "file_path": "endpoints/issues/create_issue.md",
      "content": "---\nname: create_issue\nmethod: POST\n..."
    },
    {
      "file_path": "endpoints/issues/list_issues_for_repo.md",
      "content": "---\nname: list_issues_for_repo\nmethod: GET\n..."
    }
  ]
}

Response fields

Field	Type	Description
slug	string	Integration slug
files[]	array	All skill files
files[].file_path	string	Relative path within the skill folder
files[].content	string	Full file content (markdown)

Errors

Code	Error	Description
401	unauthorized	Missing or invalid API key
404	not_found	Integration not found

Example

$ curl -H "Authorization: Bearer sk_a1b2c3d4..." \
    https://api.skillett.dev/v1/github/download