cp-skill-health-check

Diagnose Commonplace knowledge base issues across project layout, skill discovery, and environment state.

82|10|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/zby/commonplace --skill cp-skill-health-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cp-skill-health-check
Source: https://github.com/zby/commonplace/tree/main/kb/instructions/cp-skill-health-check
Command: npx skills add https://github.com/zby/commonplace --skill cp-skill-health-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill is designed to help users diagnose health issues within their Commonplace knowledge base, quickly identifying problems with skill discovery, environment configurations, and other potential issues.

Core Features & Use Cases

  • Skill Discovery Check: Determines if skills are properly promoted and discoverable.
  • Environment Configuration Check: Verifies that shell configurations are correct and necessary environment variables are set.
  • Command Path Check: Ensures that necessary commands are accessible within the project's execution environment.
  • Direnv Check: Validates the direnv setup and that hooks are properly installed.
  • Validator Check: Checks the integrity of the validator tools.
  • Quick Diagnosis Reports: Provides clear and concise reports to quickly identify the problem.
  • Use Case: If a user is experiencing issues with commonplace-* commands not working correctly, running this skill can quickly diagnose if it's an issue with the project layout, promoted skill discovery, or another common problem.

Quick Start

Run the skill by executing 'cp-skill-health-check [symptom]' in your terminal. Replace [symptom] with an optional description of what is broken to help further diagnose the issue.

Frequently Asked Questions about cp-skill-health-check

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

FAQPage Schema
How do I diagnose Commonplace knowledge base environment issues?

To diagnose Commonplace knowledge base environment issues, run a health check skill that verifies project layout, skill discovery, and environment configurations to generate a quick problem report.

Why are my commonplace commands not working in the project terminal?

Commonplace commands fail when shell configurations are incorrect or environment variables are missing; running a health check validates command paths and direnv hooks to isolate the root cause.

How does skill discovery diagnosis work in Commonplace?

Skill discovery diagnosis checks the Commonplace project layout to determine if skills are properly promoted and discoverable by agents, reporting any structural inconsistencies found.

Can I check direnv setup and validator integrity in a Commonplace environment?

You can check direnv setup and validator integrity within a Commonplace environment by executing a health check that validates hook installations and inspects validator tool configurations.

What is the best way to troubleshoot agent and skill execution problems?

The best way to troubleshoot agent and skill execution problems is executing a targeted health diagnosis that inspects package commands, launch environments, and environment state for failures.