kbanc85/claudia/diagnose
Claude Code and agent skill by kbanc85/claudia
- community
Checking that the SKILL.md file is still in the repository.
Check memory system health and troubleshoot connectivity issues. Use when memory commands aren't working, at session start if something seems wrong, or when user asks about memory status. See also: `memory-health` for the data-quality dashboard once connectivity is confirmed.
Install
npx vskill@latest install kbanc85/claudia/diagnoseSKILL.md
Diagnose
System health check for Claudia's memory infrastructure. Run this when:
- Memory commands seem unavailable
- Session context isn't loading
- User asks "is my memory working?"
- Something feels off with persistence
Process
Step 1: Check .mcp.json Configuration
Read the project's .mcp.json file and verify:
- A
claudia-memoryentry exists undermcpServers - The
commandfield points to a real Python binary - The
argsinclude--project-dirmatching the current directory
If .mcp.json is missing or has no claudia-memory entry, the daemon was never configured. Fix:
If the Python binary in the command field doesn't exist:
Step 1b: Check Active MCP Servers
List all active MCP servers (entries without _disabled prefix):
Step 2: Run Preflight Check
The daemon has a built-in preflight validator that tests all 11 startup steps:
If the preflight file exists, read it for structured results:
Step 3: Check Session Manifest
The daemon writes a manifest when it successfully enters the MCP loop:
If the manifest exists, check whether the process is still alive:
Step 4: Check Standalone Daemon
Step 5: Check Database Directly
Step 6: Check Embedding Model
Step 7: Report Results
Format the diagnosis as:
Common Issues and Fixes
Issue: "MCP server failed" in Codex
Most likely cause: The daemon crashes during startup before reaching the MCP handshake.
Fix: Run the preflight check to see exactly which step fails:
If preflight shows fixable issues, try auto-repair:
Issue: Tools not in palette but no error
Cause: Daemon started but exited before Codex could handshake, or Codex closed stdin too early.
Fix: Check the session manifest:
- If missing: daemon never reached the MCP loop (run preflight)
- If present with
exited_at: daemon started and exited cleanly (check stdin_type, should be "pipe") - If present without
exited_atand PID is dead: daemon crashed after starting
Issue: Preflight shows db_connect FAIL
Cause: Database is locked by another process.
Fix:
Issue: Preflight shows schema_load FAIL
Cause: The claudia-memory package is corrupted or incompletely installed.
Fix:
Or re-run the installer:
Issue: Preflight shows sqlite_vec WARN
Cause: sqlite-vec extension not installed. Memory works without it, but vector search is disabled.
Fix:
Issue: Daemon venv not found
Cause: Fresh install or venv was deleted.
Fix:
This recreates the venv and installs the daemon.
Issue: Wrong project directory
Cause: .mcp.json has a different --project-dir than expected.
Fix: Check the args in .mcp.json:
The --project-dir should match your current working directory. Re-run npx get-claudia . from the correct directory to fix it.
Issue: Python 3.10+ not found
Cause: System Python is too old for the daemon.
Fix: Install Python 3.10+ from python.org, Homebrew (brew install python@3.12), or your package manager.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/claudia/skills/diagnose/SKILL.md
Popularity
- Repository stars
- 292
- Repository forks
- 43
- Repository npm downloads, 7 days
- 1,433
- 7-day trend score
- 46
Stars and forks are for the whole GitHub repository, not this skill alone. Downloads are for the repository's npm package. Refreshed 22 Mar 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/kbanc85/claudia/diagnose)