---
id: learnwy/skills/lwy-dispatch
version: "e82133d9"
license: MIT
install: manual
updated: 2026-06-03
---

# lwy-dispatch — lwy-dispatch coordinates three IDE-hook events (UserPromptSubmit, Stop, SessionStart) shared across learnwy skills, running their scanners in a single process instead of spawning separate Node instances per skill. It aggregates reminders from english-learner, llm-wiki, prompt-optimizer, knowledge-consolidation, and learnwy-status into one combined output per event, cutting per-turn hook latency and reducing system-reminder spam.

Publisher: learnwy · Stars: 2 · Updated: 2026-06-03

Install (manual): `git clone https://github.com/learnwy/skills`

## SKILL.md

# learnwy-dispatch

Single-process coordinator for the three IDE-hook events shared by the learnwy-* skills.

## Why

Before this skill, every event fired N separate hook commands — one Node process per skill — and the user saw N back-to-back `<system-reminder>` blocks per turn. That multiplies the per-turn hook startup cost (~50 ms × N vs ~50 ms) and clutters context.

This skill replaces those entries with **one hook per event** that imports each skill's pure scanner function, runs them in-process, and emits a single combined reminder.

## What runs per event

### UserPromptSubmit (`hooks/user-prompt-submit.cjs`)

| Order | Module | Returns reminder when |
|---|---|---|
| 1 | `english-learner/lib/prompt-scan.scanPrompt` | English ratio ≥ 0.6 OR Chinese learn-intent OR Chinese ratio ≥ 0.3 |
| 2 | `llm-wiki/lib/prompt-scan.scanPrompt` | wiki/topics.txt has any keyword overlapping a 4+ char word in the message |
| 3 | `prompt-optimizer/lib/prompt-scan.scanPrompt` | explicit "optimize my prompt" trigger OR long structured prompt-shape |

### Stop (`hooks/stop.cjs`)

| Order | Module | Returns reminder when |
|---|---|---|
| 1 | `english-learner/lib/stop-scan.scanStop` | Assistant response has 2–4 advanced English words worth surfacing |
| 2 | `knowledge-consolidation/lib/stop-scan.scanStop` | Response shows substantive resolution signals (race condition / regression / "subtle"), not session-local trivia |

### SessionStart (`hooks/session-start.cjs`)

| Order | Module | Returns reminder when |
|---|---|---|
| 1 | `llm-wiki/lib/session-scan.scanSession` | wiki/topics.txt exists — inject ≤30 topics |
| 2 | `english-learner/lib/session-scan.scanSession` | First session of the day — push 3 due-for-review cards |
| 3 | `learnwy-status/lib/session-scan.scanSession` | First session of the ISO week — prepend a compact cross-skill digest |

Each scanner is a pure `(message | payload) => string | null` (a couple have minor side effects: prompt-optimizer appends to `~/.learnwy/prompt-optimizer/events.jsonl`; KC writes a debounce stamp).

If any scanner throws, the failure is swallowed and the others still run.

## Installation

This skill is installed by `pnpm run install:hooks` like any other skill. The corresponding `UserPromptSubmit` entries in `english-learner`, `llm-wiki`, and `prompt-optimizer` `hooks.json` files have been removed — only this skill registers a UserPromptSubmit handler now.

After upgrading from a version without `learnwy-dispatch`, run:

```bash
pnpm run uninstall:hooks   # remove the old per-skill UserPromptSubmit entries
pnpm run install:hooks     # install the dispatcher (and re-register the others)
```

The `pnpm run install:hooks` orchestrator performs an uninstall sweep before installing, so you can re-run it any time as a one-shot, idempotent operation.

## Not for direct invocation

There is no user-facing slash command and no `cli.cjs <subcommand>` other than `install` / `uninstall`. The skill description's trigger keywords exist purely so the AI surface area knows it is registered — direct invocation has no value.


[View on SkillFed](https://skillfed.io/learnwy/skills/lwy-dispatch) · [View on GitHub](https://github.com/learnwy/skills)