heal
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
Recommendednpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/healCopy 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.
- Re-read MEMORY.md → persistent knowledge base
- Review orig request + clarifying exchanges
- Current task position in larger plan
- Done vs. remaining
- Stale assumptions? Situation changed?
- 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.
- Stale assumption → replace w/ current info
- Scope drift → re-scope to stated request
- Over-complication → simplify, remove steps
- Tool pattern err → note correct pattern
- Tone mismatch → adjust style
- 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.
- Which subsystems drifted, what symptoms
- Correction applied + resolved?
- Pattern recurs → MEMORY.md brief note
- New project insight → appropriate mem file
- 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 variantmeditate— observe reasoning, clear noiseremote-viewing— extract signal without preconceptions
GitHub Repository
Related Skills
content-collections
MetaThis 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.
polymarket
MetaThis 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.
creating-opencode-plugins
MetaThis 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.
sglang
MetaSGLang 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.
