installation-doctor SKILL.md skillA

installation-doctor from alexei-led/cc-thingz is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add alexei-led/cc-thingz/installation-doctor@git:20260929.e2cd2eb

Pins git:20260929.e2cd2eb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
alexei-led/cc-thingz
Path
src/skills/installation-doctor/SKILL.md
Versions recorded
2
Latest version
git:20260929.e2cd2eb, committed Sep 29, 2026
First version recorded
Sep 8, 2026
Size
2,739 bytes
Repository stars
38
License
MIT

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add alexei-led/cc-thingz/installation-doctor@sha256:0af852dad8de5c05

The line at the top of this page pins the label git:20260929.e2cd2eb, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_f52vqu7cr4xyr34y.svg)](https://markdownregistry.com/a/art_f52vqu7cr4xyr34y)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 8, 2026 and Sep 29, 2026, about one every 21 days.

versioncommittedcommitsizeaudit
git:20260929.e2cd2eb latest2026-09-29 e2cd2eb 2,739 BA view · diff
git:20260908.fb1884d2026-09-08 fb1884d 2,407 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2739 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

alexei-led/cc-thingz · 38 stars · license MIT · pushed 2026-10-25 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_f52vqu7cr4xyr34y
GET https://markdownregistry.com/api/v1/resolve?ref=alexei-led/cc-thingz/installation-doctor
GET https://markdownregistry.com/api/v1/blob/0af852dad8de5c05a2e62afa506ccfc0bf3f7447e02ff045f508f2c7739498ea

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from alexei-led/cc-thingz

AGENTS.md AGENTS.md file
alexei-led/cc-thingz · AGENTS.md
git:20261010.bc87856 · audit A · 38 stars
CLAUDE.md CLAUDE.md file
alexei-led/cc-thingz · CLAUDE.md
git:20260512.586616a · audit B · 38 stars
brainstorming-ideas SKILL.md skill
alexei-led/cc-thingz · src/skills/brainstorming-ideas/SKILL.md · Brainstorm ideas and stress-test draft plans before coding. Use when
git:20261021.2f01d27 · audit A · 38 stars
browser-automation SKILL.md skill
alexei-led/cc-thingz · src/skills/browser-automation/SKILL.md · 'Browser automation for rendered UI exploration, validation, screenshots,
git:20260928.aef806a · audit A · 38 stars
cleanup-git SKILL.md skill
alexei-led/cc-thingz · src/skills/cleanup-git/SKILL.md · Remove merged local branches and stale git worktrees. Use when the user
git:20261021.a9f3052 · audit A · 38 stars
committing-code SKILL.md skill
alexei-led/cc-thingz · src/skills/committing-code/SKILL.md · Create normal git commits with logical grouping. Use when committing,
git:20261005.de984fb · audit A · 38 stars
configuring-git-hygiene SKILL.md skill
alexei-led/cc-thingz · src/skills/configuring-git-hygiene/SKILL.md · 'Configure safe git workflow hygiene: pre-commit/pre-push hooks, Gitleaks
git:20260928.296db92 · audit A · 38 stars
documenting-code SKILL.md skill
alexei-led/cc-thingz · src/skills/documenting-code/SKILL.md · Write, rewrite, or update project docs from implementation facts - README
git:20261005.de984fb · audit A · 38 stars
evolving-config SKILL.md skill
alexei-led/cc-thingz · src/skills/evolving-config/SKILL.md
git:20260928.23d332d · audit B · 38 stars
fixing-code SKILL.md skill
alexei-led/cc-thingz · src/skills/fixing-code/SKILL.md · Fix code defects with a reproducible feedback loop, root-cause diagnosis,
git:20261021.2f01d27 · audit A · 38 stars
improving-tests SKILL.md skill
alexei-led/cc-thingz · src/skills/improving-tests/SKILL.md · Improve test design, speed, and coverage with behavior-focused tests,
git:20261021.2f01d27 · audit A · 38 stars
looking-up-docs SKILL.md skill
alexei-led/cc-thingz · src/skills/looking-up-docs/SKILL.md · Find exact, version-correct library/API/framework docs through one lookup
git:20260928.aef806a · audit A · 38 stars

Every file in alexei-led/cc-thingz

Browse by kind, by grade A, or by owner.