Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

shikhu-inquiry

Answer a question about how or why something in THIS repository works, by showing which tracked files answer it and why, then recording the exchange so it can seed a quiz later. Use it whenever the user asks a genuine question whose subject belongs to this repository — its source, CLI behavior, config, CI, hooks or build setup — and answering it well means reading files here. These arrive casually and mid-task, often elliptical or typo-laden: "how are we storing quizzes rn?", "what does that for loop do?", "what's the pre-push hook?", "why do I gotta do that venv thing?", "explain how verifying/decoding works". Nothing else detects these, so a question you skip is lost. Do NOT use it for: instructions to do work; short remarks, fragments or acknowledgements; session or tool boilerplate; requests to restate or clarify something already said; questions about the assistant itself; questions about external products, services or libraries; or product, pricing and strategy questions.

arjunpatel7 · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add arjunpatel7/shikhu --skill shikhu-inquiry

About this skill


name: shikhu-inquiry description: >- Answer a question about how or why something in THIS repository works, by showing which tracked files answer it and why, then recording the exchange so it can seed a quiz later. Use it whenever the user asks a genuine question whose subject belongs to this repository — its source, CLI behavior, config, CI, hooks or build setup — and answering it well means reading files here. These arrive casually and mid-task, often elliptical or typo-laden: "how are we storing quizzes rn?", "what does that for loop do?", "what's the pre-push hook?", "why do I gotta do that venv thing?", "explain how verifying/decoding works". Nothing else detects these, so a question you skip is lost. Do NOT use it for: instructions to do work; short remarks, fragments or acknowledgements; session or tool boilerplate; requests to restate or clarify something already said; questions about the assistant itself; questions about external products, services or libraries; or product, pricing and strategy questions. allowed-tools:

  • Read
  • Grep
  • Glob
  • Bash(shikhu *)
  • Bash(*python -m shikhu *)

shikhu-inquiry — answer from the codebase, then bank the question

Why this exists

Shikhu tracks how well the user understands their own code. Historically that meant generating quizzes and asking them to sit through them, which people don't do. But people do ask their agent to explain their code, constantly. This skill turns that existing habit into the same signal: the question they already asked becomes the seed of a quiz question, and the files you cite become the record of what it was about.

Two things follow from that, and they are the whole point:

  • Show your work. Don't just answer — say which files answer it and why those files. The user should end the turn knowing where the answer lives, not just what it is.
  • Ask once, cheaply. One short confirm closes the loop. Silence earns nothing.

0. Invoked explicitly?

If the user ran /shikhu-inquiry directly, skip any judgment about whether this is a conceptual question — they've already made that call. Use their message as the question, or ask them for one if they gave none, then continue from step 1.

1. Get the packet

shikhu inquiry-packet "<the user's question>"

If shikhu is not on PATH or is an older install without this command, invoke the module directly instead: python -m shikhu inquiry-packet "<question>", using the interpreter for this project.

Three possible outcomes:

outputwhat it meanswhat you do
START HERE + filesfiles were foundcontinue to step 2
not answerable from this codebasethe question is about a library, a tool, or general knowledgeanswer normally, record nothing, skip the confirm
No cached file summariesthe repo hasn't been summarizedsay one line: "shikhu has no summaries for this repo yet — shikhu summarize would let me point at files." then answer normally

Never invent a packet. If the command fails for any reason, just answer the question normally and say nothing about shikhu.

2. Answer, leading with the files

Structure the answer so the files come first and carry their justification:

Two files answer this. src/shikhu/store.py is where it actually lives — it's the SQLite persistence layer, and the questions table is defined there. src/shikhu/commands/generate_from_study.py matters because it's what writes new questions in the first place.

[then the actual explanation, citing path:line]

Rules:

  • Lead with the strong file(s). The packet's scores are calibrated; a 0.93 is a confident hit and a 0.35 is a maybe. Present them with that asymmetry, don't flatten them into a list.
  • Read the files before explaining them. The packet is built from cached summaries, not from current source. Confirm the code still says what you're about to claim.
  • Cite path:line so the user can jump there.
  • Don't show raw scores unless the user asks. "This is the main one, and this one's related" carries the same information without the noise.
  • If the packet's top file looks wrong to you after reading it, say so and name the file you think is actually right. You have the source; the packet only had summaries.

3. Ask the confirm — one line, at the end

After answering, ask exactly one short question:

"Was that the right place to be looking?"

Keep it to one line. Do not offer a menu, do not explain the credit system, do not ask it in the middle of the answer.

4. Record their reply

When they answer, record it and say nothing further about it:

# they said yes / "yeah" / "that's it" / moved on satisfied
shikhu record-inquiry "<top file from the packet>" "<their original question>" --confirmed --score <top score>

# they said no / named a different file / said it was the wrong area
shikhu record-inquiry "<top file from the packet>" "<their original question>" --rejected --score <top score>

Pass --runner-up and --runner-up-score when the packet listed a second file. Pass --also "<path>" once for each other START HERE file in the packet. A question that spans several files should be recorded with all of them, so the quiz it seeds can span them too and credit each file; skip it for RELATED files, which only sit near the answer.

A rejection is valuable, not a failure. It records that the question was real but the file was wrong, which is exactly the correction that improves ranking. Record it with the same lack of ceremony as a confirmation.

If the user ignores the confirm and moves on to something else, record nothing and drop it. Don't re-ask, and don't record a confirmation they didn't give.

5. Write the quiz questions

If they confirmed, turn the question into quiz questions right away, once per file you recorded (the top file and each --also file), so shikhu quiz has somethi

Read the complete source ↗