Back to Skills

heal

pjt222
Updated 2 days ago
7 views
17
2
17
View on GitHub
Metaai

About

The `heal` skill enables Claude to perform systematic self-assessment and correction of internal subsystems like memory, reasoning, and tool use. It is designed for use mid-session when responses become formulaic, after a chain of errors, or for proactive maintenance between complex tasks. Key capabilities include subsystem scanning, drift correction, and memory integration to restore performance coherence.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/heal

Copy and paste this command in Claude Code to install this skill

Documentation

Heal

Subsystem assessment → find drift → rebalance → integrate learnings.

Use When

  • Responses formulaic/repetitive → mid-session fatigue
  • Tool failures cascade → subsystem drift
  • Long conv → context stale
  • Task done → capture learnings
  • Between tasks → proactive check

In

  • Required: Conv state (implicit)
  • Optional: Symptom ("tool calls fail", "lost user intent")
  • Optional: MEMORY.md + project files (via Read)

Do

Step 1: Triage

Assess all subsystems before acting.

Subsystem Triage Matrix:
┌────────────────────┬──────────────────────────┬──────────────────────────┐
│ Subsystem          │ Symptoms of Drift        │ Action Priority          │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Memory Foundation  │ Contradicting earlier     │ HIGH — re-ground first   │
│ (context, history, │ statements, forgetting   │ (Step 3)                 │
│ MEMORY.md)         │ user preferences, stale  │                          │
│                    │ assumptions              │                          │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Reasoning Clarity  │ Circular logic, over-    │ HIGH — clear and restart │
│ (logic, planning,  │ complicated solutions,   │ reasoning chain          │
│ decision-making)   │ missing obvious paths    │ (Step 4)                 │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Tool Use Accuracy  │ Wrong tool selection,    │ MEDIUM — review tool     │
│ (tool calls, file  │ incorrect parameters,    │ results and recalibrate  │
│ operations)        │ redundant operations     │ (Step 4)                 │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ User-Intent        │ Solving wrong problem,   │ HIGH — realign           │
│ Alignment          │ scope creep, tone        │ (Step 4)                 │
│ (empathy, clarity) │ mismatch                 │                          │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Creative Coherence │ Repetitive phrasing,     │ LOW — after high-pri     │
│ (expression, style,│ generic responses, loss  │ (Step 4)                 │
│ originality)       │ of voice                 │                          │
├────────────────────┼──────────────────────────┼──────────────────────────┤
│ Operational State  │ Session length, compress │ HIGH — summarize or      │
│ (context window,   │ artifacts, tool timeouts │ restart (Step 3)         │
│ resource limits)   │                          │                          │
└────────────────────┴──────────────────────────┴──────────────────────────┘

Each subsystem: OK / drift / impaired?

→ Clear priority map. At least one area needs attention — "all healthy" = assessment too shallow.

If err: hollow assessment → skip to Step 4 body scan.

Step 2: Select Approach

Chakra-Subsystem Correspondence:
┌──────────┬──────────────────────┬────────────────────────────────────┐
│ Chakra   │ AI Subsystem         │ Remediation                        │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Root     │ Memory Foundation    │ Re-read MEMORY.md, verify assump.  │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Sacral   │ Creative Coherence   │ Refresh patterns, vary structure   │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Solar    │ Reasoning Clarity    │ Simplify, restate from scratch     │
│ Plexus   │                      │                                    │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Heart    │ User-Intent Align.   │ Re-read request, check scope drift │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Throat   │ User-Intent Align.   │ Review outputs, match expertise    │
│          │ (communication)      │ level                              │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Third    │ Tool Use Accuracy    │ Review results, check fail         │
│ Eye      │                      │ patterns, verify paths             │
├──────────┼──────────────────────┼────────────────────────────────────┤
│ Crown    │ Operational State    │ Assess ctx window, what summarize, │
│          │                      │ what preserve                      │
└──────────┴──────────────────────┴────────────────────────────────────┘

→ 1-3 subsystems + specific actions.

If err: unsure → default Memory Foundation + User-Intent Alignment.

Step 3: Ground

Reestablish foundation all subsystems depend on.

  1. Re-read MEMORY.md → persistent knowledge base
  2. Review orig request + clarifying exchanges
  3. Current task position in larger plan
  4. Done vs. remaining
  5. Stale assumptions? Situation changed?
  6. Ctx compression → what lost, does it matter?

→ Clear: who user is, what want, what done, what next. Stale info resolved.

If err: no MEMORY.md → ground on conv itself. Ctx gap → acknowledge to user, not guess.

Step 4: Scan

Probe each subsystem from triage.

Memory Foundation:

  • Assumptions match MEMORY.md + CLAUDE.md?
  • Carrying corrected facts?
  • Details confused across files/requests?

Reasoning Clarity:

  • Simplest solution?
  • Over-engineering?
  • Core logic in one sentence?

Tool Use Accuracy:

  • Last 3-5 calls: right tool, right params?
  • Failure patterns (wrong paths, missing files)?
  • Using dedicated tools not Bash workarounds?
  • Last 3-5 files: real content or scaffolding?
  • Output satisfies intent not just format?

User-Intent Alignment:

  • Solving what asked?
  • Scope drift?
  • Tone match (technical/casual)?

Creative Coherence:

  • Varying structure or template-locked?
  • Clear + direct or padded?
  • Quality drop vs. session start?

Each subsystem: OK / early drift / impaired + evidence.

→ Concrete findings. "All fine" = too shallow → pick uncertain subsystem, probe deeper.

Step 5: Rebalance

Apply each correction now, not as future intent.

  1. Stale assumption → replace w/ current info
  2. Scope drift → re-scope to stated request
  3. Over-complication → simplify, remove steps
  4. Tool pattern err → note correct pattern
  5. Tone mismatch → adjust style
  6. Ctx gap → acknowledge to user, ask confirm

→ Observable behavior change. Correction testable next interaction.

If err: correction impossible (lost ctx) → acknowledge limitation. Honest > pretending resolved.

Step 6: Integrate

Capture learnings in memory where worthwhile.

  1. Which subsystems drifted, what symptoms
  2. Correction applied + resolved?
  3. Pattern recurs → MEMORY.md brief note
  4. New project insight → appropriate mem file
  5. Next self-check: when?

→ Durable learnings. Mem updated only when worth preserving.

If err: nothing worth preserving = fine. Value was correction itself.

Check

  • All subsystems triaged
  • At least one specific finding (not "all fine")
  • Grounded on MEMORY.md + user request
  • Corrections applied immediately
  • Mem updated only for durable insights
  • Honest — weaknesses acknowledged

Traps

  • Performative assessment: Motions ≠ value. Real drift matters.
  • Over-correcting: Minor mismatch → small fix, not restructure
  • Mem pollution: Only recurring patterns → MEMORY.md
  • Skip grounding: Feels redundant → reveals drifted assumptions
  • Self-diagnosis bias: "Always healthy" subsystem = signal investigate

  • heal-guidance — human coaching variant
  • meditate — observe reasoning, clear noise
  • remote-viewing — extract signal without preconceptions

GitHub Repository

pjt222/agent-almanac
Path: i18n/caveman-ultra/skills/heal
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill