Tool reference · Errors, rules & self-improvement
memory_skill_update
Records whether applying a skill worked, and can add new steps or an anti-pattern to it.
local stdio server writes
When to use
- You just followed a skill and want its success rate to reflect the outcome.
- A step was missing and you want to add it.
- Something went wrong and you want to record what to avoid next time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
skill_idrequired | string | — | Skill ID |
successrequired | boolean | — | Was the skill application successful? |
notes | string | — | — |
new_steps | string[] | — | Additional steps to add |
new_anti_pattern | string | — | Anti-pattern learned from failure |
Example
Arguments
{
"skill_id": "sk_4f2a",
"success": false,
"notes": "Migration locked the orders table for 40s",
"new_anti_pattern": "Adding a NOT NULL column with default on a large table"
}Result shape
{
"updated": true,
"use_id": "7d8e9f0a1b2c4d3e8f5a6b7c8d9e0f1a",
"skill": {
"id": "sk_4f2a",
"name": "safe-db-migration",
"times_used": 7,
"success_rate": 0.71,
"version": 2
}
}Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.
Server description
The description the server sends to your agent in tools/list, captured from the v14.7.0 source:
Record skill usage or refine a skill. Updates success rate and metrics.