project-health

Audit Claude Code project configuration, permissions, MCP coverage, and context files.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/moughamir/justwaitit-review --skill project-health-moughamir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-health
Source: https://github.com/moughamir/justwaitit-review/tree/main/.agents/skills/project-health
Command: npx skills add https://github.com/moughamir/justwaitit-review --skill project-health-moughamir

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Prevents Claude Code failures and messy workflows by auditing and fixing project configuration, permissions, and context files so you don’t get stuck mid-task.

Core Features & Use Cases

  • New project setup: Creates or refreshes .claude/settings.local.json, CLAUDE.md, and a safe .gitignore when a project is missing baseline configuration.
  • Permissions & MCP audit: Detects missing/stale MCP connections, permission gaps, leaked secrets, and outdated or junk permission entries, then recommends fixes (or applies them during “tidy permissions”).
  • Context quality audit & restructure planning: Evaluates CLAUDE documentation footprint, detects stale references and overlaps, and can propose splitting oversized CLAUDE.md into topic/rules files.
  • Session learnings capture: Writes concise discoveries into the appropriate persistent location (~/.claude/rules/ or CLAUDE.md) to improve future continuity.

Quick Start

Say: project health for kickoff and have Claude audit permissions, context files, and required setup for this repo.

Frequently Asked Questions about project-health

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

FAQPage Schema
How do I audit Claude Code project permissions and configuration settings?

To audit Claude Code project permissions and configuration settings, you can run a project health check to scan `.claude/settings.local.json`, detect stale permission entries, identify MCP coverage gaps, and recommend fixes for context hygiene.

How do I set up a new Claude Code project with baseline configuration files?

To set up baseline configuration for a new Claude Code project, you can initialize a project health workflow that automatically creates or refreshes `.claude/settings.local.json`, `CLAUDE.md`, and a safe `.gitignore`.

What is context hygiene and why does it matter for Claude Code workflows?

Context hygiene is the practice of evaluating your CLAUDE documentation footprint to detect stale references, overlaps, and oversized files, ensuring Claude Code has clean, high-quality context to prevent mid-task failures.

Can I restructure oversized CLAUDE.md files into separate topic files?

Yes, you can restructure oversized CLAUDE.md files by running a context quality audit, which evaluates the documentation footprint and proposes splitting the content into dedicated topic and rules files to meet size targets.

How do I scan for leaked secrets in my Claude Code project?

To scan for leaked secrets in your Claude Code project, you run a project health audit that performs targeted security scans across permissions and configuration files to detect and resolve exposed sensitive data.

When should I capture session learnings in Claude Code persistent rules?

You should capture session learnings in Claude Code persistent rules when you discover concise insights during a task, allowing the project health workflow to write them into `~/.claude/rules/` or `CLAUDE.md` to improve future continuity.