mem_pin
Pin a record so decay never marks it irrelevant and archiving cannot remove it, or unpin it to restore normal decay. Changes only the pin flag; text and approval stay intact.
Instructions
Pin a record so it never decays and is never archived, or unpin it (pinned=false). WRITES the flag and nothing else — reversible, and text, approval and updated_at are untouched. For a rule that matters precisely because it is rarely needed — a deploy gate, a safety constraint — where decay would read rarity as irrelevance. A pinned record cannot be archived until unpinned; unpinning does not un-archive it, and pinning an archived record leaves it archived. Only the owner changes the pin of a record they wrote or approved. Fails for an unknown slug. Returns the slug, the pinned state, whether the flag changed, and the record's current lifecycle. Use mem_reinforce for skills that should earn their strength. Retiring a record is the owner's own call at a terminal (skillmem skills-archive <slug>), not an agent's.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"slug": "<slug>"
},
"name": "mem_pin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Slug of the record to pin (any kind). | |
| pinned | No | true to pin (default), false to unpin. |