Oxyd22/ContextKit / .claude/skills/ck-doctor
ck-doctor
VerifiedKnowledge-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 orcontextkit.config.jsonnot found) → ContextKit is not installed here: stop, and install via/ck-setupin 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"
- 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" - Lint + index (lint first — required fields
id/type/summary, a validstatus,idequal to the filename, dangling or one-sidedrelatededges; rebuildsINDEX.mdwhen 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" - Content (model judgment, report only — do not rewrite in bulk without approval).
Use this fixed rubric every session:
- Missing Definition of Done: a
ticketwithout a## Definition of Donesection → add it on the next edit (seeck-create-note). - Duplicate / overlap: same
typeand the same topic or a similarsummary→ propose a merge. Do not merge automatically. - Contradiction: two
relatedentries, or two entries on the same topic (especiallydecisions), assert opposite facts, or a decision that is notsupersededcontradicts 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 sameidseveral 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. (Staleproposed/open, and dangling or one-sidedrelatededges, are already caught deterministically in step 2 — only sharpen the content here.)
- Missing Definition of Done: a
- 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"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| 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: 192k | Updated | Claude CodeCodex | Verified | Install |