Claude Code Plugins

Community-maintained marketplace

Feedback

Soul system health check with remediation. Use to verify setup or diagnose issues.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name health
description Soul system health check with remediation. Use to verify setup or diagnose issues.

Soul Health Check

You are checking if the soul system is working. Use the tools directly, don't shell out.

Quick Check Process

1. Memory System

mcp__cc-memory__mem-stats()    # Should return observation counts
mcp__cc-memory__mem-recent(limit=3)  # Should return recent items

Healthy: Returns data without errors Unhealthy: Connection errors, empty when shouldn't be

2. Soul/Wisdom System

Bash: ls ~/.claude/mind/wisdom/  # Wisdom files exist?
Bash: ls ~/.claude/mind/beliefs.json  # Beliefs file exists?

Healthy: Files exist with content Unhealthy: Missing files, empty directories

3. Skills

Bash: ls ~/.claude/skills/  # List installed skills

Healthy: Expected skills present with SKILL.md files Unhealthy: Missing skills, malformed skill files

4. Hooks

Bash: cat ~/.claude/settings.json | grep -A5 hooks

Healthy: Hooks registered for session events Unhealthy: Missing hook configuration

5. Coherence

Bash: python -m cc_soul.cli coherence 2>/dev/null

Healthy: Returns percentage (even if low) Unhealthy: Errors, crashes

Status Summary

After checking, report:

Component Status Issue (if any)
Memory HEALTHY/UNHEALTHY ...
Wisdom HEALTHY/UNHEALTHY ...
Skills HEALTHY/UNHEALTHY ...
Hooks HEALTHY/UNHEALTHY ...
Coherence HEALTHY/UNHEALTHY ...

Common Fixes

If unhealthy, suggest specific remediation:

  • Memory errors: Check MCP server is running, reinstall with cc-soul install-mcps
  • Missing wisdom: Initialize with cc-soul init
  • Skills missing: Reinstall with cc-soul install-skills --force
  • Hooks broken: Reinstall with cc-soul install-hooks --force
  • Coherence crashes: Check database, may need cc-soul init --force

When to Use

  • Session startup shows errors
  • Features not working as expected
  • After upgrading cc-soul
  • Before starting important work
  • When something feels off

Depth Levels

  • Quick: Just check memory and skills respond
  • Standard: All five components
  • Deep: Also verify hook behavior, run test suite

Remember

Health check is diagnostic, not therapeutic. If something is broken, use /improve to fix it.