installation-doctor
Imported from alexei-led/cc-thingz/dist/pi/skills/installation-doctor.
Install
npx skills add https://github.com/alexei-led/cc-thingz/tree/master/dist/pi/skills/installation-doctor
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alexei-led-cc-thingz@llmmart
git clone https://github.com/alexei-led/cc-thingz.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alexei-led/cc-thingz collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Installation Doctor
Inspect installed resources without a repository checkout. The helper compares files against its bundled release catalog; it does not execute hooks or modify installations.
Run
- Locate
scripts/doctor.pyrelative to this installedSKILL.md. - Use an existing Python 3.12+ interpreter with
-B. If using uv, runuv run --no-project python -B <skill-directory>/scripts/doctor.py --json. uv may populate its own cache; use an existing interpreter directly when the entire invocation must be read-only. - Select roots for the requested runtime. Without root options the helper
inspects the Codex cc-thingz marketplace cache and user flat skill directories.
For Claude or a specific installation, pass
--plugin-root <directory>. Repeat--plugin-rootor--skill-rootfor multiple locations. Any explicit root option restricts inspection to supplied roots. - Optionally pass
--config-root <.codex-directory>to check agent profile presence, or--repo <cc-thingz-checkout>for comparison with source manifests. - Summarize failed checks with paths, migration suggestions, and verification gaps. Exit 1 means findings; exit 2 means invalid arguments.
Interpretation
- Cached copies do not prove enabled plugins or duplicate execution. Inspect the runtime's enabled-plugin list before recommending removal.
- Versions are compared with the release containing this helper, not an online latest release. Without a containing native manifest, version checks are skipped.
hook-filesfails when a hook registration names a plugin file that is not on disk. A running session keeps the plugin root it started with; after a plugin update replaces that versioned directory, its hooks exit 127 or deny with "can't open file" even though the new install passes. Restart those sessions.- Hook support, helper dependencies, active plugins, and effective permissions remain unsupported by static inventory; exit 0 does not verify them.
- Report missing Python or unreadable metadata precisely. Do not install tools, change configuration, or delete caches as part of this diagnostic run.
Output
Report the inspected roots, baseline release, confirmed findings with paths, skipped or unsupported checks, and the next corrective action. Keep hook commands and credential contents out of the response.
Files (cc-thingz)
-
assets
-
catalog.json 3.8 KB
Loading…
-
-
scripts
-
doctor.py 15.7 KB
Loading…
-
-
SKILL.md 3.2 KB
--- {"description":"Diagnose cc-thingz plugin installations with the bundled read-only doctor. Use for missing installed skills, helpers, or hook files, stale package versions, duplicate packages, or migration from old cc-thingz packages. NOT for broad agent configuration audits or config edits; use evolving-config.","name":"installation-doctor"} --- <!-- Pi platform guidance --> <!-- Use installed tool names. Discover callable tools before batching independent calls in codemode; model-only UI/orchestration tools must be called directly. --> <!-- Read required skill/instruction files through direct read when exposed or through Code Mode. If an optional pruning extension is installed, verify its output protection semantics; do not assume nested-path protection. Code Mode composes calls; subagents or controllers own durable workflows. Async subagents notify natively: yield rather than poll. --> # Installation Doctor Inspect installed resources without a repository checkout. The helper compares files against its bundled release catalog; it does not execute hooks or modify installations. ## Run 1. Locate `scripts/doctor.py` relative to this installed `SKILL.md`. 2. Use an existing Python 3.12+ interpreter with `-B`. If using uv, run `uv run --no-project python -B <skill-directory>/scripts/doctor.py --json`. uv may populate its own cache; use an existing interpreter directly when the entire invocation must be read-only. 3. Select roots for the requested runtime. Without root options the helper inspects the Codex cc-thingz marketplace cache and user flat skill directories. For Claude or a specific installation, pass `--plugin-root <directory>`. Repeat `--plugin-root` or `--skill-root` for multiple locations. Any explicit root option restricts inspection to supplied roots. 4. Optionally pass `--config-root <.codex-directory>` to check agent profile presence, or `--repo <cc-thingz-checkout>` for comparison with source manifests. 5. Summarize failed checks with paths, migration suggestions, and verification gaps. Exit 1 means findings; exit 2 means invalid arguments. ## Interpretation - Cached copies do not prove enabled plugins or duplicate execution. Inspect the runtime's enabled-plugin list before recommending removal. - Versions are compared with the release containing this helper, not an online latest release. Without a containing native manifest, version checks are skipped. - `hook-files` fails when a hook registration names a plugin file that is not on disk. A running session keeps the plugin root it started with; after a plugin update replaces that versioned directory, its hooks exit 127 or deny with "can't open file" even though the new install passes. Restart those sessions. - Hook support, helper dependencies, active plugins, and effective permissions remain unsupported by static inventory; exit 0 does not verify them. - Report missing Python or unreadable metadata precisely. Do not install tools, change configuration, or delete caches as part of this diagnostic run. ## Output Report the inspected roots, baseline release, confirmed findings with paths, skipped or unsupported checks, and the next corrective action. Keep hook commands and credential contents out of the response.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.