MCP Skills Tools

Tools for managing skills in your clanker library.

list-installed-skills

List your installed AI skills with pagination support.

Parameters

Parameter	Type	Required	Default	Description
`limit`	number	No	20	Max results (1-100)
`cursor`	string	No	-	Pagination cursor from previous response

Example

{
  "tool": "list-installed-skills",
  "arguments": {
    "limit": 10
  }
}

Response

{
  "success": true,
  "data": [
    {
      "slug": "readme-generator",
      "name": "README Generator",
      "description": "Generate comprehensive README files for your projects",
      "category": "productivity"
    },
    {
      "slug": "code-reviewer",
      "name": "Code Reviewer",
      "description": "Review code for bugs, security issues, and best practices",
      "category": "development"
    }
  ],
  "pagination": { "cursor": "code-reviewer", "hasMore": true }
}

get-skill-details

Get full details of a skill including its prompt content.

Parameters

Parameter	Type	Required	Description
`slug`	string	Yes	Skill slug identifier

Example

{
  "tool": "get-skill-details",
  "arguments": {
    "slug": "readme-generator"
  }
}

Response

{
  "success": true,
  "data": {
    "slug": "readme-generator",
    "name": "README Generator",
    "description": "Generate comprehensive README files for your projects",
    "category": "productivity",
    "repository": "clanker-skills/readme-generator",
    "prompt": "# README Generator\n\nGenerate a comprehensive README.md file...",
    "installed": true
  }
}

install-skill

Add a marketplace skill to your library.

Parameters

Parameter	Type	Required	Description
`slug`	string	Yes	Skill slug to install

Example

{
  "tool": "install-skill",
  "arguments": {
    "slug": "readme-generator"
  }
}

Response

{
  "success": true,
  "data": {
    "message": "Installed \"README Generator\"",
    "skill": {
      "slug": "readme-generator",
      "name": "README Generator"
    }
  }
}

Errors

Code	Description
`ALREADY_EXISTS`	Skill is already installed
`NOT_FOUND`	Skill not found in marketplace

uninstall-skill

Remove a skill from your library.

Parameters

Parameter	Type	Required	Description
`slug`	string	Yes	Skill slug to uninstall

Example

{
  "tool": "uninstall-skill",
  "arguments": {
    "slug": "readme-generator"
  }
}

Response

{
  "success": true,
  "data": {
    "message": "Uninstalled \"README Generator\"",
    "skill": {
      "slug": "readme-generator"
    }
  }
}

Errors

Code	Description
`NOT_FOUND`	Skill is not installed
`EXECUTION_RUNNING`	Cannot uninstall while an execution is running

Usage Patterns

Browse and Install

User: "Find skills for writing documentation"

Assistant calls:
1. get-skill-details(slug: "readme-generator") to check a specific skill
2. Shows details to user
3. install-skill(slug: "readme-generator") if user wants to install

List and Run

User: "Run my README generator"

Assistant calls:
1. list-installed-skills() to find the skill
2. Starts the run via the REST API (POST /api/v1/skills/readme-generator/run)
3. get-execution-status(...) to monitor it

Skills are executed through the REST API, not an MCP tool. Over MCP you discover, install, and monitor runs.

Cleanup Library

User: "Remove skills I don't use anymore"

Assistant calls:
1. list-installed-skills() to show current library
2. uninstall-skill(slug: "...") for each skill to remove