Package as plugin

skills/wiki/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: wiki
+description: >
+  Query the RuneScape Wiki (RS3 and OSRS) for item details, quest requirements,
+  skill training guides, and Grand Exchange prices. Use this skill whenever the
+  user asks anything about RuneScape, Old School RuneScape, OSRS, RS3, or mentions
+  game-specific concepts like quests, skills, items, monsters, the Grand Exchange,
+  ironman mode, HCIM, or any RuneScape game mechanics. Also trigger when the user
+  mentions specific in-game items, quest names, skill names, or boss names that are
+  clearly RuneScape-related. Always prefer this skill over answering from memory,
+  since it pulls live, authoritative data from the wiki.
+---
+
+# RuneScape Wiki Skill
+
+This skill provides `rsw`, a CLI that queries the RuneScape Wiki for
+authoritative, up-to-date game data. It supports both **OSRS** and **RS3**.
+
+## Setup (first use)
+
+The binary is auto-built on session start if Go is available. If the binary is
+missing, compile it manually:
+
+```bash
+cd ${CLAUDE_PLUGIN_ROOT}/scripts/rsw && go build -o rsw .
+```
+
+The binary lives at `${CLAUDE_PLUGIN_ROOT}/scripts/rsw/rsw`.
+
+If Go is not installed, tell the user they need Go 1.22+ (`go.dev/dl`).
+
+## Commands
+
+The first argument is always the game: `osrs` or `rs3`.
+
+### rsw <game> search <query>
+Full-text search across wiki pages. Returns ranked titles with snippets.
+Use this to find the right page name before fetching details.
+
+### rsw <game> page <title> [--section <name>]
+Fetch a wiki page as cleaned markdown. Use `--section` to get just one section
+(e.g., "Drops", "Strategy", "Requirements"). Use `--raw` for raw wikitext.
+
+### rsw <game> item <name> [--ironman]
+The workhorse for "where do I find X" questions. Returns:
+- Item stats (examine, weight, alch values, quest association)
+- Equipment bonuses (if applicable)
+- GE price (buy/sell, volume) — or vendor/alch values with `--ironman`
+- Drop sources (monster, quantity, rarity)
+- Acquisition methods from the wiki page
+
+### rsw <game> quest <name> [--ironman]
+Quest details: skill requirements, quest prerequisites, items needed, enemies
+to defeat, and rewards. With `--ironman`, adds notes about self-sufficient
+item acquisition and HCIM combat safety.
+
+### rsw <game> skill <name> [--level <range>] [--ironman]
+Training guide for a skill. Use `--level 50-70` to filter to a specific range.
+With `--ironman`, notes which methods work without GE access.
+
+### rsw <game> price <name> [--ironman]
+Real-time GE price: instant buy/sell, recent volume, trend data.
+With `--ironman`, shows alch values and store prices instead.
+
+## Global Flags
+
+- `--ironman` / `-i` — Shifts output to self-sufficient play: hides GE prices,
+  shows vendor/alch values, emphasizes drop sources and shop locations.
+- `--raw` — Output raw wikitext (for page command).
+
+## How to Answer Questions
+
+When a user asks a RuneScape question, think about which command(s) to combine:
+
+**"Where can I find a dragon scimitar?"**
+→ `rsw osrs item "dragon scimitar"` — shows drop sources and acquisition
+→ If it's a quest reward, follow up with `rsw osrs quest "Monkey Madness I"`
+
+**"What are the requirements for Desert Treasure?"**
+→ `rsw osrs quest "Desert Treasure"`
+
+**"How do I train Prayer from 43 to 70 as an ironman?"**
+→ `rsw osrs skill prayer --level 43-70 --ironman`
+→ May also want `rsw osrs item "dragon bones" --ironman` for acquisition info
+
+**"What's the current price of an abyssal whip?"**
+→ `rsw osrs price "abyssal whip"`
+
+**"What's a good money maker at 80 combat?"**
+→ `rsw osrs search "money making"` → then `rsw osrs page "Money making guide"`
+
+### Inferring the game
+
+Most players clearly play one game or the other. Look for context clues:
+- OSRS-specific: quest names unique to OSRS
+- RS3-specific: "invention", "archaeology", "divination", "EoC", "revolution"
+- If ambiguous, ask which game they play
+
+### Combining outputs
+
+Don't just dump raw CLI output. Read it, synthesize an answer, and cite specifics.
+If the user asks "how do I get a fire cape", run the search, pull the relevant
+page sections, and give them a coherent strategy — not a wall of wikitext.