メニュー
Multi-hop query and subgraph extraction over OKF bundles for progressive disclosure. Use when packing minimal context for long-running agents, exploring the neighborhood of a concept, or answering what relates to X within N hops.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/SpillwaveSolutions/okf-plugin --skill okf-queryコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Curate OKF bundles — indexes, log.md, drift detection, broken links, orphan cleanup, staleness, and v0.1 to v0.2 migration. Use when the graph feels messy, catalogs are out of date, links break, content is stale, or the user asks to maintain, curate, or migrate an OKF bundle.
Create or update OKF concepts using the core envelope (type + title). This plugin owns Catalog and ContextPack only. For domain nouns, hand off to PKC, SAC, DEKC, or AGER.
Scaffold an OKF bundle for the graph engine — catalogs, knowledge, packs, index.md, log.md. Does not seed AgentNode, Workflow, TicketLink, or other domain nouns; those belong to PKC, SAC, DEKC, and AGER.
| name | okf-query |
| description | Multi-hop query and subgraph extraction over OKF bundles for progressive disclosure. Use when packing minimal context for long-running agents, exploring the neighborhood of a concept, or answering what relates to X within N hops. |
Answer graph questions and emit minimal context packs (subgraphs) instead of dumping entire directories.
This is the read-path optimizer. Defaults exist so a long-running agent does not eat the whole second brain.
| Intent | Approach |
|---|---|
| Neighbors of X | 1-hop inbound + outbound |
| Context pack for agent run | 2-hop outbound subgraph around the entry concept |
| Path A → B | BFS / path search on typed edges |
| By type | Filter concepts where frontmatter type matches |
| By tag | Filter on tags |
| Trust slice | Prefer verified: true and non-stale nodes |
okf graph, search, or list commands if availablepython3 "${CLAUDE_PLUGIN_ROOT}/scripts/okf-graph.py" pack <bundle> <concept> --hops 2 --max-nodes 20
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/okf-graph.py" subgraph <bundle> <concept> --hops 2
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/okf-graph.py" backlinks <bundle> <concept>
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/okf-graph.py" edges <bundle> --rel depends_on
pack → markdown field (preferred)Deep reference: references/progressive-disclosure.md.
# Context pack: <root concept>
Hops: 2 | Nodes: N | Generated: <timestamp>
## Entry
- path, type, one-line description
## Included concepts (read order)
1. ...
2. ...
## Graph (Mermaid)
```mermaid
graph LR
A --> B
## Rules
- Outbound-only by default. `--undirected` floods through Catalog hubs; prefer `impact` for “what would break?”.
- Prefer verified, active nodes when trimming packs under a size budget.
- Do not silently omit high-impact unverified nodes — flag them (`x-impact` from the owning plugin).
- Absolute paths in links inside packs so agents can open files reliably.
- Never fabricate nodes missing from the bundle.
## Done when
- Query answered with explicit hop depth and node count
- Pack is small enough for agent context (or user approved a larger extract)