# Arkon Query

Answer questions using the Arkon knowledge base.

- Repository: https://github.com/nduckmink/arkon (1515 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-06-03
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nduckmink/arkon --skill arkon-query -g -a claude-code -y`
Codex: `npx skills add nduckmink/arkon --skill arkon-query -g -a codex -y`
Cursor: `npx skills add nduckmink/arkon --skill arkon-query -g -a cursor -y`
Gemini CLI: `npx skills add nduckmink/arkon --skill arkon-query -g -a gemini-cli -y`

## Description

Answer questions using the Arkon knowledge base. Searches wiki first, drills into raw sources only when needed. Supports quick, standard, and deep modes. Triggers on: what do we know about, find in KB, look up, query:, arkon query, search the wiki, tell me about, based on the KB.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# arkon-query: Query the Knowledge Base

The wiki has already done the synthesis work. Read strategically, answer precisely. Raw sources are a fallback, not the first stop.

---

## Query Modes

| Mode | Trigger | Tools used | Best for |
|------|---------|-----------|---------|
| **Quick** | `query quick: ...` or simple factual Q | `search_wiki` only | Direct lookups, names, dates |
| **Standard** | default | `search_wiki` → 2-4 pages | Most questions |
| **Deep** | `query deep: ...` or "thorough", "find everything" | Full wiki traverse + source drill-down | Cross-cutting synthesis |

---

## Quick Mode

1. Call `search_wiki(query, top_k=5)`. If the top result has high similarity (≥ 80%) and its summary answers the question, respond immediately.
2. If not satisfied, call `read_wiki_page(slug)` for the top 1-2 results.
3. If still not found, say "Not in quick cache, run as standard query?"

Do not call `read_wiki_index` or source tools in quick mode.

---

## Standard Query Workflow

1. **`search_wiki(query)`**, ranked list of pages. Read summaries.
2. **`read_wiki_page(slug)`** for the 2-4 most relevant results. Follow wikilinks `[[slug]]` at depth 1 only if they look essential.
3. Synthesize the answer in chat. Cite with page slugs: _(Source: `concept/onboarding`)_.
4. If the question reveals a gap: "I don't have enough on X in the KB. Want to check the raw sources?"

---

## Deep Mode

1. `search_wiki` + `read_wiki_index` to map coverage.
2. Read all relevant pages. Follow wikilinks at depth 2 if needed.
3. If wiki coverage is thin for a specific claim, drill into raw sources (see below).
4. Always cite both wiki pages and source documents used.

---

## Source Drill-Down (citations or precise text)

Use when: the wiki has paraphrased something and you need the exact wording, or the user asks "what does the document actually say."

The rest: https://github.com/nduckmink/arkon/blob/HEAD/skills/arkon-query/SKILL.md