Oxyd22/ContextKit / .claude/skills/ck-refs-lookup
ck-refs-lookup
VerifiedLook up reference repos (read-only) through the condensed contract index instead of reading the whole repo. Run: /ck-refs-lookup <topic/type/endpoint>
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
SKILL.md
View on GitHub---
name: ck-refs-lookup
description: "Look up reference repos (read-only) through the condensed contract index instead of reading the whole repo. Run: /ck-refs-lookup <topic/type/endpoint>"
disable-model-invocation: false
---
# ck-refs-lookup
Answers questions about the **reference repos** from the condensed index at `$CK_ROOT/.claude/contextkit/cache/references/<repo>.md` — without reading the whole repo.
> 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
```bash
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"
```
Paths in the config are relative to `$CK_ROOT`.
## Flow
1. Read the index files: `$CK_ROOT/.claude/contextkit/cache/references/*.md`.
2. Find the matching entry (sections: Contracts / API-Specs / Parity ({platform} <-> {repo})).
3. **Check freshness** from the frontmatter (`sha`, `indexed`, `status`). Compare with the repo:
```bash
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; }
git -C "$CK_ROOT/<references.path>/<repo>" rev-parse --short HEAD
```
- SHA **matches** and `status: indexed` → answer from the index, and cite the source as `repo@sha`.
- SHA **differs** or `status: needs-extraction` → the index is stale: recommend `/ck-refs-sync` AND, for this question, read **only the relevant files** in the reference repo (not the whole repo). If the live fact goes beyond the question itself (a new contract signature, endpoint, or parity note) → add it to the matching section of the existing stub (a `file:line` reference, terse, as in `ck-refs-sync`). Leave `status` at `needs-extraction`, so the finding is kept.
4. A question outside contracts / API / parity → say so: not indexed. Read it live.
Paths come from `.claude/contextkit/contextkit.config.json` (`references.path` + `repos`). Keep answers short, with a `file:line` reference into the reference repo when you can. Reference repos are **read-only** — write only in the project. The cache stub under `$CK_ROOT/.claude/contextkit/cache/` belongs to the project and may be patched.
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: 198k | 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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |