checkup

Inspect a Compass project for structural and operational issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hodor/claude-compass --skill checkup-hodor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkup
Source: https://github.com/hodor/claude-compass/tree/main/plugin/skills/checkup
Command: npx skills add https://github.com/hodor/claude-compass --skill checkup-hodor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps identify issues in a Compass project, such as missing agents, stale handoffs, unclosed tasks, vault inconsistencies, and broken hooks, allowing for quick diagnosis and maintenance.

Core Features & Use Cases

  • Problem Scanning: Inspects a Compass project for common issues affecting its health.
  • Actionable Reporting: Provides clear reports on what is wrong and suggests solutions.
  • Use Case: After a long break from a project or before starting a sprint, use this Skill to ensure everything is in order and to spot any potential problems.

Quick Start

Run 'compass check' or use 'checkup' to perform a health check on your Compass project.

Frequently Asked Questions about checkup

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

FAQPage Schema
How do I run a health check on my Compass project to find missing agents and broken hooks?

A Compass health check scans for missing agents, stale handoffs, unclosed tasks, vault inconsistencies, and broken hooks. It reports actionable items to correct these issues and restore operational integrity.

What structural inconsistencies can a Compass project diagnosis identify?

A Compass project diagnosis identifies missing agents, stale handoffs, unclosed tasks, vault inconsistencies, and broken hooks. It reports actionable items to correct these structural and operational issues.

When should I perform project integrity maintenance on my Compass installation?

Perform project integrity maintenance after a long break from a project or before starting a sprint. This ensures your Compass installation is fully operational and helps spot potential workflow problems early.

Does the Compass health check provide actionable solutions for vault inconsistencies?

Yes, the Compass health check provides actionable reporting. It inspects vault inconsistencies and other issues, then delivers clear reports on what is wrong and suggests specific solutions to correct them.

How do I fix stale handoffs and unclosed tasks in my Compass project?

To fix stale handoffs and unclosed tasks, run 'compass check' to inspect your Compass project. The resulting actionable report will highlight these issues and suggest corrections to restore project health.