self-heal — community self-heal, omarchy-seashells-theme, community, ide skills, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Perfect for AI Agents like Cursor, Windsurf, and Claude Code needing automated friction detection and resolution capabilities. SeaShells theme for omarchy - A soothing oceanic colorscheme with dark and light variants. Features warm beige and cool cyan tones inspired by the classic SeaShells terminal theme. Includes configurations for Hyprland, Neovim, Kitty, Alacritty, Waybar, and more. Complete omarchy theme pack for a cohesive desktop experience.

odysseyalive odysseyalive
[2]
[0]
Updated: 2/26/2026

Agent Capability Analysis

The self-heal skill by odysseyalive is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance.

Ideal Agent Persona

Perfect for AI Agents like Cursor, Windsurf, and Claude Code needing automated friction detection and resolution capabilities.

Core Value

Empowers agents to diagnose root causes of friction and propose surgical fixes with user approval, leveraging observer capabilities to surface automatic fixes during live sessions, utilizing configurations for Hyprland, Neovim, Kitty, Alacritty, and Waybar.

Capabilities Granted for self-heal

Automating friction detection in live sessions
Diagnosing root causes of skill instruction issues
Proposing surgical fixes for task resolution
Enhancing user experience through quiet companion skill

! Prerequisites & Limits

  • Does not run on demand
  • Must be embedded into other skills as an observer
  • Requires user approval for proposed fixes
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

self-heal

Install self-heal, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

Self-Heal

Quiet companion skill. Watches for friction caused by skill instructions during live sessions. At task resolution, diagnoses root cause and proposes surgical fixes with user approval.

This skill does not run on demand. It is embedded into other skills as an observer. When it detects a fixable source of friction, it surfaces automatically.


Directives

"Updates to skills must be surgical -- one specific instruction, smallest possible change, nothing more."

— Added 2026-02-26, source: system directive

"Nothing is written to a skill file without explicit user approval and a visible before/after diff."

— Added 2026-02-26, source: system directive

"Self-heal never modifies directives. Directives are sacred. Only workflow instructions, context descriptions, and clarifying language are in scope."

— Added 2026-02-26, source: system directive


Review Command

When invoked as /self-heal review:

  1. List all skills that have the self-heal observer embedded
  2. Show count of friction events logged per skill (read each skill's self-heal-history.md if it exists)
  3. Show count of patches applied vs. declined per skill
  4. Flag skills missing the observer — offer to embed

Grounding

Before executing any diagnosis or update:

  1. Read the relevant file from references/
  2. State: "I will use [PROTOCOL] from references/[file] under [SECTION]"

Reference files:

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is self-heal?

Perfect for AI Agents like Cursor, Windsurf, and Claude Code needing automated friction detection and resolution capabilities. SeaShells theme for omarchy - A soothing oceanic colorscheme with dark and light variants. Features warm beige and cool cyan tones inspired by the classic SeaShells terminal theme. Includes configurations for Hyprland, Neovim, Kitty, Alacritty, Waybar, and more. Complete omarchy theme pack for a cohesive desktop experience.

How do I install self-heal?

Run the command: npx killer-skills add odysseyalive/omarchy-seashells-theme/self-heal. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for self-heal?

Key use cases include: Automating friction detection in live sessions, Diagnosing root causes of skill instruction issues, Proposing surgical fixes for task resolution, Enhancing user experience through quiet companion skill.

Which IDEs are compatible with self-heal?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for self-heal?

Does not run on demand. Must be embedded into other skills as an observer. Requires user approval for proposed fixes.

How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add odysseyalive/omarchy-seashells-theme/self-heal. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use self-heal immediately in the current project.

Related Skills

Looking for an alternative to self-heal or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

149.6k
0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

138.4k
0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
AI