cp-skill-health-check

Solid

Run a Commonplace health check when agents, skills, or commonplace-* commands do not work correctly. Diagnoses project layout, promoted skill discovery, direnv/PATH state, package commands, and common launch-environment failures.

AI & Automation 69 stars 9 forks Updated today CC-BY-4.0

Install

View on GitHub

Quality Score: 88/100

Stars 20%
61
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

## EXECUTE NOW Use this skill when the user reports that a Commonplace KB is not working correctly: missing skills, `commonplace-*` command failures, validation not found, the agent runtime not seeing the venv, or confusion around direnv. It applies both to installed KBs, where shipped content lives under `kb/commonplace/`, and to the Commonplace source repo, where shipped content lives directly under `kb/`. Target symptom: `$ARGUMENTS` This skill diagnoses and reports. Do not edit shell config, rerun `commonplace-init`, install packages, or change symlinks unless the user explicitly asks for repair after seeing the diagnosis. ## Step 1 - Identify the workspace shape Run: ```bash pwd git rev-parse --show-toplevel 2>/dev/null || true git remote -v 2>/dev/null || true test -d kb && echo "kb: present" || echo "kb: missing" test -f AGENTS.md && echo "AGENTS.md: present" || echo "AGENTS.md: missing" test -f CLAUDE.md && echo "CLAUDE.md: present" || echo "CLAUDE.md: missing" test -d kb/commonplace && echo "kb/commonplace: present" || echo "kb/commonplace: missing" test -d src/commonplace && echo "src/commonplace: present" || echo "src/commonplace: missing" test -d kb/reference && echo "kb/reference: present" || echo "kb/reference: missing" test -d kb/instructions && echo "kb/instructions: present" || echo "kb/instructions: missing" test -f .envrc && echo ".envrc: present" || echo ".envrc: missing" test -d .venv && echo ".venv: present" || echo ".venv: missing" ``` Interpreta...

Details

Author
zby
Repository
zby/commonplace
Created
3 months ago
Last Updated
today
Language
Python
License
CC-BY-4.0

Similar Skills

Semantically similar based on skill content — not just same category