Skip to content
cccskills
FreePublished on GitHub

health

Verify Claude configuration health — CLAUDE.md, settings.json, hooks, agents, skills, secrets scan, and MCP reachability. Reports ✅/⚠️/❌ for each check.

The English summary is being prepared. Showing the original description.

Works withPlaywright
See how to install

Files included (1)

  • SKILL.md3.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Health Skill — Claude Brain Configuration Validation

Verify that the Claude Brain configuration is healthy and complete.

Steps

1. CLAUDE.md

  • Exists and is not empty
  • Line count: wc -l < CLAUDE.md
  • Size: wc -c < CLAUDE.md (budget: ≤32KB = 32768 bytes)
  • Contains key sections: Skills Roster, Exit Checklist, Terminal Rules

2. settings.json

  • .claude/settings.json exists and is valid JSON: jq . .claude/settings.json
  • Contains hooks configuration block

3. Hook Scripts

  • All .claude/hooks/*.sh files exist and are executable:
    for h in .claude/hooks/*.sh; do test -x "$h" || echo "NOT_EXEC: $h"; done
    

4. Subagents

  • All .claude/agents/*.md files exist and are non-empty:
    for f in .claude/agents/*.md; do [ -s "$f" ] || echo "EMPTY: $f"; done
    

5. Skills

  • All .claude/skills/*/SKILL.md files exist
  • Each has name: and description: in frontmatter:
    for f in .claude/skills/*/SKILL.md; do grep -q '^name:' "$f" || echo "BAD FRONTMATTER: $f"; done
    

6. Error Log

  • claude/tasks/CLAUDE_ERRORS.md exists (warn if missing)

7. Secrets Scan

git ls-files | xargs grep -l 'BEGIN.*PRIVATE KEY\|password\s*=\s*[^{][^"\x27]\{8,\}' 2>/dev/null | head -10

Report any matches as ⚠️ warnings.

8. MCP Tool Reachability

Check that the required runtimes are available (all MCP tools run via uvx or npx):

command -v uvx &>/dev/null && echo "uvx: ✅" || echo "uvx: ❌ missing — install via: pip install uv"
command -v npx &>/dev/null && echo "npx: ✅" || echo "npx: ⚠️ missing — install Node.js (for playwright)"
command -v ccc &>/dev/null && echo "cocoindex CLI (ccc): ✅" || echo "cocoindex CLI (ccc): ⚠️ optional — install via: pip install cocoindex"
# uvx-based: codebase-memory-mcp, code-review-graph, serena, cocoindex-code-mcp-server (available when uvx installed)

Report Format

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Claude Brain Health — <repo>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  CLAUDE.md budget         ✅ 187 lines / 4.2KB (budget: 32KB)
  settings.json            ✅ valid JSON + hooks block
  Hook scripts             ✅ 9/9 executable
  Subagents                ✅ 5/5 non-empty
  Skills                   ✅ 49/49 have valid frontmatter
  Error log                ✅ CLAUDE_ERRORS.md exists
  Secrets scan             ✅ no leaks detected
  codebase-memory-mcp      ⚠️ missing — run setup-plugins.sh
  cocoindex (ccc)          ✅ installed
  code-review-graph        ✅ installed
  uvx (playwright/serena)  ✅ installed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Overall: ⚠️ healthy with 1 warning
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

After the table, list any ⚠️/❌ items with one-line fix instructions.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ask

Free

Route a codebase question to the right tool — structural graph, semantic search, or risk analysis. Use when you need to find or understand code without knowing exact file names.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Auto-configure CLAUDE.md and claude/ knowledge docs for a new project. Use when setting up Brain Bootstrap in a new repository. Discovers the codebase, fills in templates, and writes project-specific configuration.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Use before any new feature, component, or behavioral change — when you need to explore requirements and design before writing code

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Activate safety guards for the session. Use /careful before critical operations — blocks rm -rf, DROP TABLE, git push --force, kubectl delete namespace, docker system prune via PreToolUse hook.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Generate a user-facing changelog from git commits — categorize, filter noise, translate to user language. Runs in isolated fork context.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

Save session state before context gets full or before ending. Writes current task state, branch, and loaded docs to claude/tasks/todo.md so the next session can resume cleanly.

The English summary is being prepared. Showing the original description.

brain-bootstrap/claude-code-brain-bootstrap11Updated Apr 25, 2026

See all skills by brain-bootstrap

Report a problem with this skill