Skip to content
Skills Library
Programming · Review & audit

command-coverage

/command-coverage

Audits the @lorekit/web dashboard so every navigation target and user action is reachable from BOTH the command palette (⌘K) and a Linear-style keyboard shortcut, then (in apply mode) wires the missing ones behind a confidence gate. Crawls the app routes, settings/docs section tables, and page-level actions, diffs them against the useCommand registry, assigns Linear key conventions (F=filter, L=label, C=create, g→ for navigation), and records approach insights to LoreKit. Use before shipping a new page or action, or when checking shortcut/palette parity. Triggers on "check shortcut coverage",

Repository
lorekit ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Audits the @lorekit/web dashboard so every navigation target and user action is reachable from BOTH the command palette (⌘K) and a Linear-style keyboard shortcut, then (in apply mode) wires the missing ones behind a confidence gate. Crawls the app routes, settings/docs section tables, and page-level actions, diffs them against the useCommand registry, assigns Linear key conventions (F=filter, L=label, C=create, g→ for navigation), and records approach insights to LoreKit. Use before shipping a new page or action, or when checking shortcut/palette parity. Triggers on "check shortcut coverage",

Triggers from the description

check shortcut coverage

Arguments

/command-coverage [audit|apply] [--scope dashboard|docs|blog|all]
Original author description

Audits the @lorekit/web dashboard so every navigation target and user action is reachable from BOTH the command palette (⌘K) and a Linear-style keyboard shortcut, then (in apply mode) wires the missing ones behind a confidence gate. Crawls the app routes, settings/docs section tables, and page-level actions, diffs them against the useCommand registry, assigns Linear key conventions (F=filter, L=label, C=create, g→ for navigation), and records approach insights to LoreKit. Use before shipping a new page or action, or when checking shortcut/palette parity. Triggers on "check shortcut coverage",

How it works

  1. Mode Detection
  2. Workflow
  3. Required Reading by Phase
  4. Report format (Phase 4)
  5. Core Principles
  6. Anti-patterns
  7. Definition of Done
Original SKILL.md headings · 176 lines, 1,329 words
SKILL.md preview
---
name: command-coverage
description: >
  Audits the @lorekit/web dashboard so every navigation target and user
  action is reachable from BOTH the command palette (⌘K) and a Linear-style
  keyboard shortcut, then (in apply mode) wires the missing ones behind a
  confidence gate. Crawls the app routes, settings/docs section tables, and
  page-level actions, diffs them against the useCommand registry, assigns
  Linear key conventions (F=filter, L=label, C=create, g→ for navigation),
  and records approach insights to LoreKit. Use before shipping a new page or
  action, or when checking shortcut/palette parity. Triggers on "check
  shortcut coverage", "audit the command palette", "are these actions in the
  palette", "wire up keyboard shortcuts", "command palette parity",
  "/command-coverage".
argument-hint: '[audit|apply] [--scope dashboard|docs|blog|all]'
license: MIT
metadata:
  author: mthines
  version: '1.0.0'
  workflow_type: applied
  tags:
    - command-palette
    - keyboard-shortcuts
    - linear-conventions
    - cmdk
    - web-audit
    - accessibility
    - coverage
    - lorekit
    - nextjs
---

# Command Coverage

Ensures every place a user can **navigate** to and every **action** they can
take in `packages/web` is exposed consistently in two surfaces:

1. The **command palette** (⌘K / Ctrl+K), and
2. A **keyboard shortcut** that follows Linear's conventions.

The skill crawls the web app, builds two inventories (what exists vs. what is
registered), diffs them into a coverage matrix, recommends a Linear-style
binding for each gap, and — in `apply` mode — writes the missing
`useCommand({...})` registrations behind a confidence gate. It reads and
writes LoreKit memory so the *approach* (conventions, decisions, prior gaps)
compounds across runs.

> **This `SKILL.md` is a thin index.** The crawl procedure, the Linear key
> map, the auto-wire mechanics, the LoreKit protocol, and the concrete
> palette API contract live in `rules/*.md` and `references/*.md` — load only
> what the current phase needs.

---

## Mode Detection

Parse `$ARGUMENTS`. First token selects the mode; `--scope` narrows the crawl.

| Mode    | Default | Trigger                                                            |
| ------- | ------- | ----------------------------------------------------------------- |
| `audit` | **yes** | Default. "check coverage", "audit palette", or no mode argument.  |
| `apply` |         | "wire up", "fix the gaps", "apply", or `$ARGUMENTS` starts `apply`. |

`--scope` (default `all`): `dashboard` (routes + actions behind auth),
`docs` (the public `/docs` palette), `blog` (the public `/blog` palette), or
`all`.

State the detected mode and scope in one line before continuing:

```text
Mode: audit
Scope: all
```

`apply` runs the full `audit` pipeline first — it never wires blind.

---

## Workflow

| Phase | Name        | Rule / reference                                                     | Gate                                                        |
| ----- | ----------- | ------------------------------------------------------------------- | ---------------------------------------------------------- |
| 0     | Recall      | [`rules/lorekit-memory.md`](./rules/lorekit-memory.md)             | Prior conventions + decisions loaded from LoreKit           |
| 1     | Inventory   | [`rules/crawl-inventory.md`](./rules/crawl-inventory.md)          | Nav targets, actions, and the command registry all enumerated |
| 2     | Diff        | [`rules/crawl-inventory.md`](./rules/crawl-inventory.md)          | Coverage matrix built (target × {palette, shortcut})        |
| 3     | Recommend   | [`rules/linear-shortcuts.md`](./rules/linear-shortcuts.md)        | Every gap has a proposed binding; no token collisions       |
| 4     | Report      | this file (Report format)                                          | Matrix + recommendations presented to the user              |
| 5     | Wire (apply)| [`rules/auto-wire.md`](./rules/auto-wire.md)                      | Registrations written only at `confidence ≥ 90%` + user OK  |
| 6     | Record      | [`rules/lorekit-memory.md`](./rules/lorekit-memory.md)            | New insights/decisions written back to LoreKit              |

`audit` stops after Phase 4 and still runs Phase 6. `apply` runs all phases.

---

## Required Reading by Phase

Load on demand — do not preload.

| Phase   | Files                                                                                              |
| ------- | ------------------------------------------------------------------------------------------------- |
| 0, 6    | [`rules/lorekit-memory.md`](./rules/lorekit-memory.md)                                             |
| 1, 2    | [`rules/crawl-inventory.md`](./rules/crawl-inventory.md), [`references/palette-api.md`](./references/palette-api.md) |
| 3       | [`rules/linear-shortcuts.md`](./rules/linear-shortcuts.md)                                         |
| 5       | [`rules/auto-wire.md`](./rules/auto-wire.md), [`references/palette-api.md`](./references/palette-api.md) |

The concrete `packages/web` palette contract (the `Command` type, the
`useCommand` hook-position rules, existing bindings, id-prefix conventions)
lives in [`references/palette-api.md`](./references/palette-api.md). Read it
before crawling or wiring so the skill never re-derives — or drifts from —
the real API.

---

## Report format (Phase 4)

Emit one coverage matrix, then the recommendations. Group by surface scope.

```text
## Coverage — dashboard

| Target / action        | Route / trigger  | Palette | Shortcut | Warrants shortcut? | Gap  | Proposed shortcut | Proposed palette      | Prio |
| ---------------------- | ---------------- | ------- | -------- | ------------------ | ---- | ----------------- | --------------------- | ---- |
| Overview               | /overview        | ✅ nav-overview | ✅ g o | yes            | —    | —                 | —                     | —    |
| Lore Explorer          | /lore            | ✅ nav-explorer | ✅ g e | yes            | —    | —                 | —                     | —    |
| Settings → Plan        | /settings/plan   | ✅ settings-plan | ❌   | no — occasional | —    | —                 | —                     | —    |
| Filter (Explorer)      | FilterMenu open  | ❌      | ❌       | yes                | both | `f`               | "Filter lore…" (Lore) | P1   |
| Focus search (Explorer)| search input     | ❌      | ❌       | yes                | both | `/`               | "Search lore…" (Lore) | P1   |
| Keyboard help          | (none)           | ❌      | ❌       | yes                | both | `?`               | "Keyboard shortcuts…" | P3   |
```

Rules for the matrix:

- One row per navigation target AND per page-level action.
- `Palette` cites the registering command `id` when present, `❌` when absent.
- `Shortcut` cites the key sequence when present, `❌` when absent.
- `Gap` is frequency-aware, one of:
  - `—` covered — has a palette entry, and either has a shortcut or does not
    warrant one (occasional/destructive/deep). A palette-only settings page is
    `—`, NOT a shortcut gap.
  - `palette` — missing its palette entry (always a real gap; the floor).
  - `shortcut` — passes the shortcut test but has no shortcut.
  - `both` — missing the palette entry AND warrants a shortcut.
- Include a `Warrants shortcut?` judgment per row (`yes` / `no — occasional` /
  `no — destructive` / `contextual`) so a palette-only row reads as a decision,
  not an oversight.
- `Proposed shortcut` / `Proposed palette` — the suggested binding for a gap
  row (from [`rules/linear-shortcuts.md`](./rules/linear-shortcuts.md)), or `—`
  for a covered row. Every gap row MUST carry a proposal so the user can
  challenge each one individually. When a proposal is blocked (e.g. a handler
  must be lifted first, or a token collides), append the blocker inline —
  e.g. `` `f` ⚠ lift FilterMenu handler `` or `` `g o` ✗ taken → `g m` ``.
- `Prio` is `P1`–`P4` (P1 = high-frequency, both surfaces missing).
- Never invent coverage: a target counts as covered only if a real
  `useCommand` registration is found in the crawl (Phase 1).
- The separate prose "Recommendations" list is now redundant with the
  `Proposed*` columns — keep only cross-cutting notes (new features, ordering)
  below the table, not per-row repeats.

---

## Core Principles

1. **Palette is the floor; a shortcut is earned.** EVERY navigable target and
   real action gets a command-palette entry — that is the discoverability
   baseline and its absence is always a gap. A keyboard shortcut is the
   accelerator layer, added ONLY when the target passes the shortcut test
   (frequent + global + flow-critical — see
   [`rules/linear-shortcuts.md`](./rules/linear-shortcuts.md)). A low-frequency
   destination with a palette entry and no shortcut is correctly covered, not
   a gap. Shortcuts are a scarce, memorable resource — spending one on a rarely
   used page devalues the whole keymap.
2. **Follow Linear, do not invent.** `g` prefix is reserved for navigation;
   single letters (F, L, C, …) are context actions; ⌘K opens the palette.
   Reuse the repo's existing bindings before adding new ones.
3. **Table-driven truth.** Navigation is already driven by `DOCS_SECTIONS`,
   `SETTINGS_SECTIONS`, and `BLOG_SECTIONS`; register from those tables, never
   a hand-copied list that can drift.
4. **Never wire blind.** `apply` only writes after the `audit` matrix and a
   `confidence ≥ 90%` gate; show the diff and get explicit user confirmation.
5. **Compound the approach.** Read LoreKit at the start, write decisions and
   newly-found conventions at the end, so the next run is smarter.

---

## Anti-patterns

- Registering commands inside a `.map()` — breaks React hook order. Wrap each
  item in its own component (see the `DocsCommandItem` pattern).
- Reusing a key token already bound (checked against the live registry).
- Binding a single-letter action that fires globally without respecting the
  input/textarea/contenteditable guard.
- Claiming a target is covered from the route table alone without finding its
  `useCommand` registration.
- Adding a nav command with a `g`-prefix that collides with `g o/e/s/g`.

---

## Definition of Done

- [ ] Mode + scope stated in one line.
- [ ] LoreKit recalled (Phase 0) and recorded (Phase 6).
- [ ] Coverage matrix covers every route, section-table entry, and page action.
- [ ] Every gap has a proposed Linear-style binding with no token collision.
- [ ] `apply` only: each new registration passed the confidence gate, the
      user confirmed, and `pnpm nx typecheck web` is green.
- [ ] One-line summary of the coverage delta delivered to the user.
Files in this package (6)
  • SKILL.md 11 KB
  • references/palette-api.md 8 KB
  • rules/auto-wire.md 5 KB
  • rules/crawl-inventory.md 7 KB
  • rules/linear-shortcuts.md 8 KB
  • rules/lorekit-memory.md 4 KB

Versions

The database has no other skills named command-coverage.

Database snapshot: 13.11.2026 · package version 047b2fb99a00 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100studio-shortcuts
    Keyboard shortcut conventions for Supabase Studio. Use when adding a repeated user action, toolbar action, list/table operation, or sub-page navigation that should have shortcut coverage, when registering or changing a shortcut, or when adding a search/filter Input (which needs…
  • 100maintaining-command-palette
    Use when adding, changing, or reviewing dashboard pages, routes, sidebar navigation, named resource lists or detail pages, resource names, permissions, feature gates, or Command K search candidates in client/dashboard; also for missing Cmd+K results, launcher search, and…
  • 100keyboard-shortcuts
    Audit a web app for missing keyboard shortcuts and implement them end to end: a command registry, context-scoped bindings, a command palette, visible kbd hints, a ? help sheet, invariant tests, and WCAG 2.1.4 compliance. Use whenever the user mentions keyboard shortcuts,…
  • 85keyboard-shortcuts
    Reference for keyboard shortcut implementation, keybinding registration, shortcut parity with vim and other TUI tools, and the complete shortcut assignment table across all sidecar plugins. Use when adding or modifying keyboard shortcuts, checking shortcut assignments, resolving…
  • 100add-operation
    Points to the single how-to for adding a new LoreKit operation — an MCP tool, CLI command, or REST route — across the tool catalog, both permission mirrors, the audit vocabulary, and docs. Thin skill; the procedure lives in docs/adding-an-operation.md, never duplicated here.…
  • 100desktop-commands-audit
    Check the work on this branch (or a PR) for anything in Hive Desktop that should be reachable from the command palette or bindable to a key and is not, then add the catalog entries and palette rows. Use when asked to audit keybindings, shortcuts, or the palette, to check what ⌘K…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.