agentleFS
PratiyushPratiyush/llm-wiki/.claude/skills/llmwiki-query/SKILL.md

llmwiki-query

Skill383 starsChanged 5 months agoMITView on GitHub

Answer a question by querying the user's llmwiki. Use when the user asks about their own past work — "what did I decide about X", "what have I been working on", "how did I solve Y", "what's my preferred approach to Z", or any question that the wiki (built from their session history) might answer. Always read the wiki first before falling back to external search.

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 9 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Do NOT invoke for questions that can be answered without the user's personal knowledge base (e.g., "how does TCP work?" → answer from …

    line 22
  2. Distinctive:

    Follow the Query Workflow from the repo's CLAUDE.md:

    line 26
  3. Distinctive:

    If yes, write it using the Synthesis Page Format from CLAUDE.md.

    line 44
  4. Distinctive:

    If the wiki has no relevant pages:

    line 53
  5. Distinctive:

    If the topic is unlikely to be in session history, offer to answer from general knowledge (and make that explicit: "this is general …

    line 57
  6. Distinctive:

    Don't make up wiki pages that don't exist.

    line 61
  7. Distinctive:

    Don't confuse general knowledge with wiki content in the answer.

    line 62
  8. Distinctive:

    Don't over-cite — if the whole answer comes from one page, cite once at the top.

    line 63
  9. Distinctive:

    Don't write a wall of text.

    line 64

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

llmwiki-query

What this skill does

Reads the user's local llmwiki (llmwiki/wiki/) and synthesises an answer to their question, with [[wikilink]] citations pointing to the source pages.

When to use

Invoke this skill when the user asks a question about their own work or history. Examples:

  • "What did I decide about the AiShorts backend?"
  • "What MCP servers do I have configured?"
  • "How did I fix the X bug last week?"
  • "What's my preferred way to ingest sessions?"
  • "What have I been working on in the germanly project?"

Do NOT invoke for questions that can be answered without the user's personal knowledge base (e.g., "how does TCP work?" → answer from general knowledge).

Workflow

Follow the Query Workflow from the repo's CLAUDE.md:

  1. Locate the llmwiki install (see llmwiki-sync skill for the fallback search order).
  2. Read wiki/index.md to identify the set of pages that might be relevant.
  3. Read wiki/overview.md to get the living synthesis context.
  4. Pick the most relevant pages (sources, entities, concepts) based on the question.
  5. Read those pages with the Read tool.
  6. Synthesise an answer with inline [[wikilink]] citations. Quote directly from source pages when the wording matters.
  7. If the answer is substantial (3+ paragraphs), ask the user whether to save it as a synthesis page:
    Would you like me to save this as wiki/syntheses/<slug>.md for future reference?
    If yes, write it using the Synthesis Page Format from CLAUDE.md.
  8. Append to wiki/log.md:
    ## [YYYY-MM-DD] query | <short question>

Fallback behavior

If the wiki has no relevant pages:

  1. Tell the user "I don't see anything about this in your wiki yet."
  2. Suggest running /wiki-sync to pull in any recent sessions that might cover the topic.
  3. If the topic is unlikely to be in session history, offer to answer from general knowledge (and make that explicit: "this is general knowledge, not from your wiki").

Don't do

  • Don't make up wiki pages that don't exist.
  • Don't confuse general knowledge with wiki content in the answer.
  • Don't over-cite — if the whole answer comes from one page, cite once at the top.
  • Don't write a wall of text. The answer should be as short as the question allows.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.