cp-skill-health-check

Featured

Diagnose Commonplace project layout, promoted-skill discovery, user-level uv tool installation, command PATH ownership, and launch-environment failures.

AI & Automation 88 stars 11 forks Updated yesterday CC-BY-4.0

Install

View on GitHub

Quality Score: 89/100

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

Skill Content

# Commonplace Health Check ## EXECUTE NOW Use this skill when a Commonplace KB has missing skills, missing or failing `commonplace-*` commands, or commands that work in one shell but not in an IDE or agent runtime. It applies both to installed KBs, where shipped content lives under `kb/commonplace/`, and to the Commonplace source repository, where shipped content lives directly under `kb/`. Target symptom: `$ARGUMENTS` Do not modify files during diagnosis. Report the evidence and the smallest repair. Apply a repair only when the user asked for one. ## Step 1 — Locate the project and classify the layout From the workspace root, inspect: ```bash pwd 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 "layout: installed KB" || true test -f pyproject.toml && test -d src/commonplace && echo "layout: source repo" || true test -d .agents/skills && echo ".agents/skills: present" || true test -d .claude/skills && echo ".claude/skills: present" || true ``` Interpretation: - Installed KB: `kb/commonplace/{notes,reference,instructions}/` exists. - Source repository: `pyproject.toml`, `src/commonplace/`, and top-level `kb/{notes,reference,instructions}/` exist. - Neither: the wrong directory is open or `commonplace-init` has not run. - `.venv` is not a Commonplace layout requirement. A project may still own one for unrelated dependencies. ## Step 2 —...

Details

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

Similar Skills

Semantically similar based on skill content — not just same category