chore: import upstream snapshot with attribution

skills/cli-contexts/SKILL.md

@@ -0,0 +1,389 @@
+---
+name: cli-contexts
+description: Manage context engineering configurations, RTK filter sets, and conversation sessions from the CLI. Apply context-relay settings and inspect active context pipelines.
+---
+<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->
+
+## Overview
+
+Manage context engineering configurations, RTK filter sets, and conversation sessions from the CLI. Apply context-relay settings and inspect active context pipelines.
+
+## Quick install
+
+```bash
+npm install -g omniroute   # or: npx omniroute
+omniroute --version
+```
+
+## Subcommands
+
+### `context-eng`
+
+**Example:**
+
+```bash
+omniroute context-eng
+```
+
+### `context-eng analytics`
+
+**Flags:**
+
+- `--period <p>`
+
+**Example:**
+
+```bash
+omniroute context-eng analytics
+```
+
+### `context-eng caveman`
+
+**Example:**
+
+```bash
+omniroute context-eng caveman
+```
+
+### `context-eng config`
+
+**Example:**
+
+```bash
+omniroute context-eng config
+```
+
+### `context-eng show`
+
+**Example:**
+
+```bash
+omniroute context-eng show
+```
+
+### `context-eng set`
+
+**Flags:**
+
+- `--aggressiveness <n>`
+- `--max-shrink-pct <n>`
+- `--preserve-tags <list>`
+
+**Example:**
+
+```bash
+omniroute context-eng set
+```
+
+### `context-eng rtk`
+
+**Example:**
+
+```bash
+omniroute context-eng rtk
+```
+
+### `context-eng config`
+
+**Example:**
+
+```bash
+omniroute context-eng config
+```
+
+### `context-eng show`
+
+**Example:**
+
+```bash
+omniroute context-eng show
+```
+
+### `context-eng set`
+
+**Flags:**
+
+- `--token-budget <n>`
+- `--reserve-pct <n>`
+
+**Example:**
+
+```bash
+omniroute context-eng set
+```
+
+### `context-eng filters`
+
+**Example:**
+
+```bash
+omniroute context-eng filters
+```
+
+### `context-eng list`
+
+**Example:**
+
+```bash
+omniroute context-eng list
+```
+
+### `context-eng add`
+
+**Flags:**
+
+- `--priority <n>`
+- `--action <a>`
+
+**Example:**
+
+```bash
+omniroute context-eng add
+```
+
+### `context-eng remove <id>`
+
+**Flags:**
+
+- `--yes`
+
+**Example:**
+
+```bash
+omniroute context-eng remove <id>
+```
+
+### `context-eng test`
+
+**Example:**
+
+```bash
+omniroute context-eng test
+```
+
+### `context-eng raw-output <id>`
+
+**Example:**
+
+```bash
+omniroute context-eng raw-output <id>
+```
+
+### `context-eng combos`
+
+**Example:**
+
+```bash
+omniroute context-eng combos
+```
+
+### `context-eng list`
+
+**Example:**
+
+```bash
+omniroute context-eng list
+```
+
+### `context-eng get <id>`
+
+**Example:**
+
+```bash
+omniroute context-eng get <id>
+```
+
+### `context-eng assignments <id>`
+
+**Example:**
+
+```bash
+omniroute context-eng assignments <id>
+```
+
+### `contexts`
+
+**Example:**
+
+```bash
+omniroute contexts
+```
+
+### `contexts list`
+
+List all contexts
+
+**Example:**
+
+```bash
+omniroute contexts list
+```
+
+### `contexts add <name>`
+
+Add a new context
+
+**Flags:**
+
+- `--api-key <k>`
+- `--api-key-stdin`
+- `--access-token <t>`
+- `--access-token-stdin`
+- `--scope <s>`
+- `--description <d>`
+
+**Example:**
+
+```bash
+omniroute contexts add <name>
+```
+
+### `contexts use <name>`
+
+Switch active context
+
+**Example:**
+
+```bash
+omniroute contexts use <name>
+```
+
+### `contexts current`
+
+Show the active context (server, auth, scope)
+
+**Flags:**
+
+- `--name-only`
+
+**Example:**
+
+```bash
+omniroute contexts current
+```
+
+### `contexts show <name>`
+
+Show context details
+
+**Example:**
+
+```bash
+omniroute contexts show <name>
+```
+
+### `contexts remove <name>`
+
+Remove a context
+
+**Flags:**
+
+- `--yes`
+
+**Example:**
+
+```bash
+omniroute contexts remove <name>
+```
+
+### `contexts rename <old> <new>`
+
+Rename a context
+
+**Example:**
+
+```bash
+omniroute contexts rename <old> <new>
+```
+
+### `contexts export`
+
+Export contexts to JSON
+
+**Flags:**
+
+- `--out <path>`
+- `--no-secrets`
+
+**Example:**
+
+```bash
+omniroute contexts export
+```
+
+### `contexts import <file>`
+
+Import contexts from a JSON file
+
+**Flags:**
+
+- `--merge`
+
+**Example:**
+
+```bash
+omniroute contexts import <file>
+```
+
+### `sessions`
+
+**Example:**
+
+```bash
+omniroute sessions
+```
+
+### `sessions list`
+
+**Flags:**
+
+- `--user <u>`
+- `--kind <k>`
+- `--active`
+- `--limit <n>`
+
+**Example:**
+
+```bash
+omniroute sessions list
+```
+
+### `sessions show <sessionId>`
+
+**Example:**
+
+```bash
+omniroute sessions show <sessionId>
+```
+
+### `sessions expire <sessionId>`
+
+**Flags:**
+
+- `--yes`
+
+**Example:**
+
+```bash
+omniroute sessions expire <sessionId>
+```
+
+### `sessions expire-all`
+
+**Flags:**
+
+- `--yes`
+
+**Example:**
+
+```bash
+omniroute sessions expire-all
+```
+
+### `sessions current`
+
+**Example:**
+
+```bash
+omniroute sessions current
+```