cp-skill-health-check

Solid

Diagnose Commonplace project layout, promoted-skill discovery, command paths, package commands, and launch-environment failures.

AI & Automation 81 stars 10 forks Updated yesterday CC-BY-4.0

Install

View on GitHub

Quality Score: 89/100

Stars 20%
64
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
5 months ago
Last Updated
yesterday
Language
Python
License
CC-BY-4.0

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

skilldoctor

Diagnose the Claude Code skills installed on this machine — why one never triggers, and whether Claude can see it at all. Use when the user says a skill isn't firing, isn't triggering, or is being ignored; asks to check, audit, or debug their skills; mentions the skill description budget, truncated skills, or duplicate skills; or asks whether a skill they installed is safe to trust. Runs a deterministic CLI over every installed skill at once, so it catches whole-system problems no single-file check can see.

0 Updated today
gulmezeren2-byte
AI & Automation Solid

spec-kitty-setup-doctor

Install, verify, and recover the modern Spec Kitty 2.0.11+ operating surface. Triggers: "set up Spec Kitty", "skills missing", "next is blocked", "runtime is broken", "doctrine assets are missing", "my agent can't find the skills". Does NOT handle: generic coding questions with no Spec Kitty context, direct runtime loop advancement, or editorial glossary maintenance.

1,449 Updated today
Priivacy-ai
AI & Automation Listed

skill-doctor

Audit a Claude Code skill or workflow for structural quality, idempotency, and best-practice compliance. Runs 30+ binary checks grounded in Anthropic's official skill authoring docs, Agent Patterns research, and production patterns. Produces a severity-weighted report (FAIL/WARN/NOTE). Use when the user says 'audit this skill', 'check my skill', 'skill-doctor', 'review my workflow', or provides a path to a skill directory. Do NOT use for codebase audits (use meta-audit) or PRD reviews (use meta-review-prd).

3 Updated 4 days ago
arthjean