git:20261012.3d8c788 to git:20261019.1b4e3ca

---

name: pages

description: >

Browse, open, or print distilled pages, reusing the `wenlan pages` CLI for the

the page when one matches, or shows a small native picker when 2-4 match.

argument-hint: "[query] [--print]"

allowed-tools: ["Bash", "AskUserQuestion", "mcp__plugin_wenlan_wenlan__get_page_revisions"]

---

Open a distilled page fast. The **`wenlan pages`** CLI does the open (one local

command on your PATH — nothing to register, source, or install). This skill only

adds a small native picker for the ambiguous case.

**Do not read a page body unless the user asks to see it here. Never render a

metadata card.** By default resolve by title / filename only — the file opens in

your editor, which renders and searches it better than chat. Keeping bodies out

is what keeps this cheap. The one exception is `--print` below.

Resolve the binary once (the agent shell's PATH may omit `~/.wenlan/bin`):

```bash

W="$(command -v wenlan || echo "$HOME/.wenlan/bin/wenlan")"

```

Run ONE Bash block **with the command sandbox DISABLED** (opening calls the OS

launcher `open`/`xdg-open`, which a sandboxed shell can't reach, and would else

fail with `kLSUnknownErr`):

```bash

W="$(command -v wenlan || echo "$HOME/.wenlan/bin/wenlan")"

"$W" pages "<query>"

```

Act on its output — do NOT re-fetch, list again, or read bodies:

- **`Opened <path>`** → one page matched and is now open. Print that line. Done.

- **`N matches for … `** followed by `title · filename` lines → several matched:

- **2-4 matches** → present them with `AskUserQuestion`, one option each:

**label** = title, **description** = filename (titles can repeat, so the

filename is the real handle). On pick, open it:

```bash

"$W" pages "<picked-filename>"

```

Print the `Opened` line it returns.

- **more than 4 matches** → print the list verbatim and ask the user to narrow

the query or pass one of the filenames. No picker — it can't show more than 4.

The picker stays small by construction: ≤4 short options, no page bodies, and

the open is a single CLI call that prints one line.

When the user passes `--print`, or asks to see the page in chat because there is

no editor or GUI at hand, print instead of opening. Sandbox can stay on; nothing

launches:

```bash

W="$(command -v wenlan || echo "$HOME/.wenlan/bin/wenlan")"

"$W" pages "<query>" --print

```

It prints the matched page's text followed by its sources. Show that output.

The `N matches` and `no page matches` cases work exactly as above; once one

filename is chosen, rerun with it and `--print`.

```bash

W="$(command -v wenlan || echo "$HOME/.wenlan/bin/wenlan")"

"$W" --format table pages

```

Prints the newest ~20 titles (CLI-capped; `--limit 0` for all). Show them and

that's the lossy, 4-cap case the CLI list avoids.

## Explicit changelog lookup

Only when the user explicitly asks for a page's changelog or version history,

resolve its stable id without reading the page body. Resolve the page ID first

with `wenlan pages "<query-or-filename>" --resolve-id`.

```bash

"$W" pages "<query-or-filename>" --resolve-id

```

If several pages match, use the same picker/narrowing flow above and rerun with

the selected filename. Then call `get_page_revisions(page_id="<resolved-id>")`.

## When NOT to use

- Raw memory lookups → `/recall`.