Skill: Get Skill

List available skills in a category or retrieve the source code of a specific skill for agent introspection and discovery.

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

ParameterTypeRequiredDescription
categorystringNoThe skill category to list (e.g., web, platform, quickbooks, sage-intacct). If omitted, all categories and their skills are listed.
skill_namestringNoThe 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.
versionstringNoThe version of the skill to retrieve (e.g., v1.0). Defaults to the latest version if omitted. Only used when skill_name is provided.
Tip

When both category and skill_name are omitted, the skill returns a high-level inventory of all categories and the skills within each. This is useful when an agent needs to understand the full scope of its capabilities.

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:

json
{
  "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:

json
{
  "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.
Note

This skill is particularly valuable for agents that use Create Skill — they can inspect existing skill implementations to understand conventions and patterns before generating new skill code.


Related skills: Create Skill | Export File