Skip to content

Oxyd22/ContextKit / .claude/skills/ck-refs-lookup

ck-refs-lookup

Verified

Look up reference repos (read-only) through the condensed contract index instead of reading the whole repo. Run: /ck-refs-lookup <topic/type/endpoint>

FileKindSize
SKILL.mdskill md2.7 KB
---
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.
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: 198kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall