Skill Tools
These 14 tools manage the skill graph — a store of reusable procedures, recipes, and how-to knowledge. Skills have steps, triggers, file patterns, and usage tracking, making them ideal for capturing repeatable workflows. Skills are mirrored to .skills/ markdown files for IDE access.
These tools are always available. Mutation tools (marked below) are hidden when the skill graph is set to readonly.
skills_create
Mutation — hidden in readonly mode
Creates a new skill (reusable procedure or recipe).
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
title | Yes | — | Skill title |
description | Yes | — | What this skill does |
steps | No | — | Array of step strings (ordered procedure) |
triggers | No | — | Array of trigger phrases that should activate this skill |
inputHints | No | — | Array of expected inputs or prerequisites |
filePatterns | No | — | Array of glob patterns for relevant files (e.g. ["src/**/*.ts"]) |
tags | No | — | Array of tags |
source | No | "user" | Source: "user", "learned" |
confidence | No | 1.0 | Confidence score (0-1) |
Returns
{ skillId } — the generated skill ID.
When to use
Save a procedure you want to reuse. For instance, after successfully deploying a service, save the steps as a skill so it can be recalled next time.
skills_update
Mutation — hidden in readonly mode
Partially updates a skill. Only send fields you want to change.
Parameters
| Parameter | Required | Description |
|---|---|---|
skillId | Yes | Skill ID to update |
| All skills_create fields | No | Any field from skills_create can be updated |
Returns
{ skillId, updated }.
skills_delete
Mutation — hidden in readonly mode
Deletes the skill, all its relations, proxy nodes, and mirror directory.
Parameters
| Parameter | Required | Description |
|---|---|---|
skillId | Yes | Skill ID to delete |
Returns
{ skillId, deleted }.
skills_get
Fetches a skill with all its relations and metadata.
Parameters
| Parameter | Required | Description |
|---|---|---|
skillId | Yes | Skill ID |
Returns
{ id, title, description, steps, triggers, inputHints, filePatterns, source, confidence, tags, usageCount, lastUsedAt, createdAt, updatedAt, dependsOn, dependedBy, related, variants, crossLinks? } — includes resolved relations and usage statistics.
skills_list
Lists skills with optional filters.
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
source | No | — | Filter by source ("user", "learned") |
tag | No | — | Filter by tag |
filter | No | — | Substring match on title |
limit | No | 50 | Maximum results |
Returns
Array of { id, title, source, tags, usageCount, lastUsedAt }.
skills_search
Hybrid semantic search over skills.
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
query | Yes | — | Search query (natural language) |
topK | No | 5 | Seed results for BFS |
bfsDepth | No | 1 | BFS expansion hops |
maxResults | No | 5 | Maximum results |
minScore | No | 0.5 | Minimum relevance score |
bfsDecay | No | 0.8 | Score decay per hop |
searchMode | No | hybrid | hybrid, vector, or keyword |
Returns
Array of { id, title, description, source, confidence, usageCount, tags, score }.
skills_recall
Broad skill recall with a lower relevance threshold than skills_search.
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
context | Yes | — | Description of the current task or situation |
topK | No | 5 | Maximum results |
minScore | No | 0.3 | Minimum relevance score (lower than skills_search) |
Returns
Array of { id, title, description, steps, triggers, source, tags, score, usageCount } — includes full steps so skills can be applied immediately.
When to use
At the start of a complex task, cast a wide net to find potentially relevant procedures. skills_recall uses a lower minScore (0.3 vs 0.5) than skills_search, so it returns more results including less obvious matches. For instance: "What skills might help with setting up a new microservice?"
skills_bump_usage
Mutation — hidden in readonly mode
Increments a skill's usage counter and updates its last-used timestamp.
Parameters
| Parameter | Required | Description |
|---|---|---|
skillId | Yes | Skill ID |
Returns
{ skillId, usageCount, lastUsedAt }.
When to use
After successfully applying a skill's recipe, bump its usage. This helps surface frequently used skills in future searches.
skills_link
Mutation — hidden in readonly mode
Creates a relation between two skills.
Parameters
| Parameter | Required | Description |
|---|---|---|
fromId | Yes | Source skill ID |
toId | Yes | Target skill ID |
kind | Yes | Relation type: depends_on, related_to, or variant_of |
Returns
{ fromId, toId, kind, created }.
skills_create_link
Mutation — hidden in readonly mode
Links a skill to another skill (same-graph) or to a node in the docs, code, files, knowledge, or tasks graph (cross-graph). Omit targetGraph for skill-to-skill links.
Parameters
| Parameter | Required | Description |
|---|---|---|
skillId | Yes | Source skill ID |
targetId | Yes | Target skill ID (same-graph) or target node ID in external graph (cross-graph) |
targetGraph | No | Target graph: "docs", "code", "files", "knowledge", "tasks". Omit for skill-to-skill links. |
kind | Yes | Relation type (free-form string) |
projectId | No | Target project ID (for cross-project links) |
Returns
{ skillId, targetId, targetGraph, kind, created }.
When to use
Connect a skill to the code or docs it relates to. For instance, link a deployment skill to the configuration files it uses.
skills_delete_link
Mutation — hidden in readonly mode
Deletes a link from a skill to another skill (same-graph) or to a node in an external graph (cross-graph). Omit targetGraph for skill-to-skill links. Orphaned proxy nodes are cleaned up automatically.
Parameters
| Parameter | Required | Description |
|---|---|---|
skillId | Yes | Skill ID |
targetId | Yes | Target node ID |
targetGraph | No | Target graph. Omit for skill-to-skill links. |
projectId | No | Target project ID |
Returns
{ skillId, targetId, deleted }.
skills_find_linked
Reverse lookup: finds all skills that link to a specific node in another graph.
Parameters
| Parameter | Required | Description |
|---|---|---|
targetId | Yes | Target node ID |
targetGraph | Yes | Which graph the target is in |
kind | No | Filter by relation kind |
projectId | No | Target project ID |
Returns
Array of { skillId, title, kind, source, tags }.
When to use
Check if any skills are associated with a piece of code or documentation before modifying it.
skills_add_attachment
Mutation — hidden in readonly mode
Attaches a file to a skill.
Parameters
| Parameter | Required | Description |
|---|---|---|
skillId | Yes | Skill ID |
filePath | Yes | Absolute path to the file on disk |
Returns
{ filename, mimeType, size, addedAt }.
Max 10 MB per file. Max 20 attachments per entity.
skills_remove_attachment
Mutation — hidden in readonly mode
Removes a file attachment from a skill.
Parameters
| Parameter | Required | Description |
|---|---|---|
skillId | Yes | Skill ID |
filename | Yes | Filename to remove |
Returns
{ deleted: filename }.