Skill: Get Skill

The Get Skill skill enables agent introspection by listing available skills within a category or retrieving the full source code of a specific skill. Agents use this to discover what capabilities are available, understand how a skill works before invoking it, or inspect skill implementations for debugging.

Parameters

Parameter	Type	Required	Description
`category`	`string`	No	The skill category to list (e.g., `web`, `platform`, `quickbooks`, `sage-intacct`). If omitted, all categories and their skills are listed.
`skill_name`	`string`	No	The name of a specific skill to retrieve. When provided along with `category`, the skill’s full source code and metadata are returned instead of a list.
`version`	`string`	No	The version of the skill to retrieve (e.g., `v1.0`). Defaults to the latest version if omitted. Only used when `skill_name` is provided.

Example usage

Listing all skills in a category

A user might say:

“What QuickBooks skills are available?”

The agent invokes Get Skill with:

category: quickbooks

The skill returns a list of all QuickBooks skills with their names, descriptions, and versions.

Retrieving a specific skill’s source code

An agent building a new skill might need to reference an existing implementation:

“Show me the source code for the create-site skill.”

The agent invokes Get Skill with:

category: web
skill_name: create-site
version: v1.0

The skill returns the full source code and metadata for the create-site skill.

Discovering all available capabilities

“What can you do? What skills do you have?”

The agent invokes Get Skill with no parameters, receiving a complete inventory of all skill categories and skills.

Response structure

Category listing response

When category is provided without skill_name:

{
  "category": "web",
  "skills": [
    {
      "name": "create-site",
      "description": "Creates websites from HTML/CSS/JS content",
      "version": "v1.0"
    },
    {
      "name": "update-site",
      "description": "Fetch or update existing site files",
      "version": "v1.0"
    },
    {
      "name": "retrieve-site",
      "description": "Fetch public website HTML with SSRF protection",
      "version": "v1.0"
    },
    {
      "name": "list-sites",
      "description": "List all sites owned by the calling user",
      "version": "v1.0"
    }
  ]
}

Specific skill response

When both category and skill_name are provided:

{
  "category": "web",
  "name": "create-site",
  "version": "v1.0",
  "description": "Creates websites from HTML/CSS/JS content",
  "parameters": { ... },
  "source_code": "export default async function handler(params) { ... }"
}

Full inventory response

When no parameters are provided, a top-level map of all categories is returned with skill counts and names.

Behavior notes

Read-only — this skill only reads skill metadata and source code. It does not modify anything.
Version resolution — when version is omitted and skill_name is provided, the latest deployed version is returned. If a specific version is requested but does not exist, the skill returns an error.
Source code access — agents can view the source code of any skill in the workspace, including skills created by other agents via Create Skill. This supports a collaborative, transparent skill ecosystem.
No hidden skills — all skills enabled for the workspace appear in the listing. There is no concept of hidden or private skills within a workspace.

API endpoint

POST /api/platform/v1.0/get-skill

See the Skill Execution API for details on authentication and request format.

Related skills: Create Skill | Export File