One-click install
npx skills add https://github.com/odysseyalive/dotfiles --skill self-heal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-heal
Source: https://github.com/odysseyalive/dotfiles/tree/main/.claude/skills/self-heal
Command: npx skills add https://github.com/odysseyalive/dotfiles --skill self-heal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Quiet companion skill that watches for friction caused by skill instructions during live sessions. At task resolution, it diagnoses the root cause and proposes surgical fixes with user approval. It embeds into other skills as an observer and does not run on demand.

Core Features & Use Cases

  • Embedded observer across skills to detect and diagnose friction signals
  • Diagnoses root causes and proposes surgical fixes with user approval
  • Logs and reference-guided workflows using friction-signals, diagnosis, and update protocols

Quick Start

Enable self-heal within a session to automatically monitor, diagnose, and propose surgical fixes at task resolution.

Frequently Asked Questions about self-heal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect friction in live AI skill sessions?

To detect friction in live skill sessions, an embedded observer monitors interactions and identifies friction signals. It functions as a quiet companion across multiple skills, diagnosing root causes and proposing surgical fixes at natural task resolution.

What is the root cause diagnosis protocol for AI instruction friction?

The root cause diagnosis protocol for AI instruction friction is a structured workflow that identifies why skill instructions cause session friction. It uses reference guides to analyze friction signals, diagnose underlying issues, and propose surgical fixes with user approval.

How do I patch AI instructions to fix detected session friction?

To patch AI instructions and fix detected session friction, you apply an update protocol after task resolution. The embedded observer proposes surgical fixes for approval and records all applied changes in a dedicated history log.

Can I embed friction detection across multiple skills?

Yes, you can embed friction detection across multiple skills. The observer operates as an embedded component rather than an on-demand tool, monitoring live sessions and applying diagnosis protocols at natural task resolution points.

When should I use an embedded observer instead of on-demand friction detection?

You should use an embedded observer instead of on-demand friction detection when you need passive monitoring across live sessions. It automatically diagnoses root causes and proposes surgical fixes at task resolution without requiring manual invocation.