Skip to content

Oxyd22/ContextKit / .claude/skills/ck-read-note

ck-read-note

Unverified

Look up project knowledge (notes, decisions, tickets) through the generated INDEX instead of reading every entry. Use it so earlier decisions are considered before a new one. Run: /ck-read-note <topic/question>

ck-read-note

Answers questions from the knowledge folder (the "second brain") with few tokens: the index first, then only the matching entries. Never read the whole folder.

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"

Paths in .claude/contextkit/contextkit.config.json are relative to $CK_ROOT.

Flow

  1. Read INDEX.md ($CK_ROOT/<knowledge.path>/INDEX.md). One file is the whole map: each entry is [[id]] (status) — summary, grouped into Decisions / Notes / Tickets. If the index is missing or looks stale → /ck-doctor (it rebuilds the index).
  2. From the summary lines, pick the 1–3 relevant entries. Open only those (<knowledgePath>/<id>.md). Follow related wikilinks at most 1 hop.
  3. Answer with a pointer to [[id]]. For decisions, name the status (superseded → point at the successor via related).
  4. File the answer back when it is worth keeping. If the answer was a non-trivial synthesis (a comparison, an analysis, a newly noticed link between several entries), suggest /ck-create-note — otherwise the work disappears into the chat. Questions then grow the knowledge base too, as well as new captures. Do not file a plain lookup (that is noise).
  5. If the index has nothing on it, say so: not documented. If it should be recorded → suggest /ck-create-note.

knowledge.path comes from .claude/contextkit/contextkit.config.json. Before a new decision, always check here whether one already exists (including one that was superseded).

planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 117kUpdated Claude CodeCodexUnverifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 107kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 107kUpdated Claude CodeCodexVerifiedInstall