Oxyd22/ContextKit / .claude/skills/ck-read-note
ck-read-note
UnverifiedLook 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 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"
Paths in .claude/contextkit/contextkit.config.json are relative to $CK_ROOT.
Flow
- 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). - From the
summarylines, pick the 1–3 relevant entries. Open only those (<knowledgePath>/<id>.md). Followrelatedwikilinks at most 1 hop. - Answer with a pointer to
[[id]]. For decisions, name the status (superseded→ point at the successor viarelated). - 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). - 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).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |
| 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: 117k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 107k | Updated | Claude CodeCodex | Verified | Install |
| 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: 107k | Updated | Claude CodeCodex | Verified | Install |