Skip to content

Oxyd22/ContextKit / .claude/skills/ck-doctor

ck-doctor

Verified

Knowledge-base hygiene: setup doctor, schema lint, rebuild the index, freshness stamp. Run: /ck-doctor

ck-doctor

Keeps the "second brain" consistent. Deterministic checks run in a script; then report the findings.

If .claude/contextkit/ is missing (script or contextkit.config.json not found) → ContextKit is not installed here: stop, and install via /ck-setup in the hub.

Resolve project root

CK_ROOT="${CLAUDE_PROJECT_DIR:-}"; [ -d "$CK_ROOT/.claude/contextkit" ] || CK_ROOT="$(d="$PWD"; while [ "$d" != "/" ] && [ ! -d "$d/.claude/contextkit" ]; do d="$(dirname "$d")"; done; echo "$d")"; [ -d "$CK_ROOT/.claude/contextkit" ] || { echo "ContextKit not found: no .claude/contextkit in this directory or any parent"; exit 1; }
echo "$CK_ROOT"
  1. Check the setup:
    CK_ROOT="${CLAUDE_PROJECT_DIR:-}"; [ -d "$CK_ROOT/.claude/contextkit" ] || CK_ROOT="$(d="$PWD"; while [ "$d" != "/" ] && [ ! -d "$d/.claude/contextkit" ]; do d="$(dirname "$d")"; done; echo "$d")"; [ -d "$CK_ROOT/.claude/contextkit" ] || { echo "ContextKit not found: no .claude/contextkit in this directory or any parent"; exit 1; }
    python3 "$CK_ROOT/.claude/contextkit/scripts/doctor.py"
    
  2. Lint + index (lint first — required fields id / type / summary, a valid status, id equal to the filename, dangling or one-sided related edges; rebuilds INDEX.md when the schema is clean, otherwise stops with the errors):
    CK_ROOT="${CLAUDE_PROJECT_DIR:-}"; [ -d "$CK_ROOT/.claude/contextkit" ] || CK_ROOT="$(d="$PWD"; while [ "$d" != "/" ] && [ ! -d "$d/.claude/contextkit" ]; do d="$(dirname "$d")"; done; echo "$d")"; [ -d "$CK_ROOT/.claude/contextkit" ] || { echo "ContextKit not found: no .claude/contextkit in this directory or any parent"; exit 1; }
    python3 "$CK_ROOT/.claude/contextkit/scripts/knowledge.py"
    
  3. Content (model judgment, report only — do not rewrite in bulk without approval). Use this fixed rubric every session:
    • Missing Definition of Done: a ticket without a ## Definition of Done section → add it on the next edit (see ck-create-note).
    • Duplicate / overlap: same type and the same topic or a similar summary → propose a merge. Do not merge automatically.
    • Contradiction: two related entries, or two entries on the same topic (especially decisions), assert opposite facts, or a decision that is not superseded contradicts a newer one → mark it in the findings and ask for a resolution.
    • LOG.md as a trace: read the last 20 ## [ headings of <knowledgePath>/LOG.md. The same id several times in a short span is a signal that the entry was created too early or is still half-formed, beyond the audit trail itself. (Stale proposed / open, and dangling or one-sided related edges, are already caught deterministically in step 2 — only sharpen the content here.)
  4. Freshness stamp + log:
    CK_ROOT="${CLAUDE_PROJECT_DIR:-}"; [ -d "$CK_ROOT/.claude/contextkit" ] || CK_ROOT="$(d="$PWD"; while [ "$d" != "/" ] && [ ! -d "$d/.claude/contextkit" ]; do d="$(dirname "$d")"; done; echo "$d")"; [ -d "$CK_ROOT/.claude/contextkit" ] || { echo "ContextKit not found: no .claude/contextkit in this directory or any parent"; exit 1; }
    mkdir -p "$CK_ROOT/.claude/contextkit/cache" && date > "$CK_ROOT/.claude/contextkit/cache/.last-knowledge-check"
    python3 "$CK_ROOT/.claude/contextkit/scripts/knowledge.py" --log lint "<n> entries · <m> warnings"
    
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 192kUpdated Claude CodeCodexVerifiedInstall