Skills

Arkon Query

Answer questions using the Arkon knowledge base.

Install

npx skills add nduckmink/arkon --skill arkon-query -g -a claude-code -y
Repository
nduckmink/arkon1.5k
Category
Engineering
Updated
5mo ago
License
See repository
Context cost
Lightabout 858 tokens
Runs scripts
No, instructions only

What it does

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.

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

ModeTriggerTools usedBest for
Quickquery quick: ... or simple factual Qsearch_wiki onlyDirect lookups, names, dates
Standarddefaultsearch_wiki → 2-4 pagesMost questions
Deepquery deep: ... or "thorough", "find everything"Full wiki traverse + source drill-downCross-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."

Read the whole SKILL.md on GitHub

More in Engineering