Skip to content

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

Python

fix missing skills

yuhaoe1e48ba6d055
diff --git a/.github/scripts/sync_root_skills.py b/.github/scripts/sync_root_skills.py
index f22745310..7da0ea8b2 100644
--- a/.github/scripts/sync_root_skills.py
+++ b/.github/scripts/sync_root_skills.py
@@ -12,7 +12,14 @@ ROOT_SKILLS_DIR = REPO_ROOT / "skills"
def _canonical_skill_id(source: Path) -> str:
rel = source.relative_to(REPO_ROOT)
- software_dir = rel.parts[0]
+ parts = rel.parts
+ if "cli_anything" in parts:
+ package_index = parts.index("cli_anything") + 1
+ if package_index < len(parts):
+ package_name = parts[package_index]
+ return f"cli-anything-{package_name.replace('_', '-')}"
+
+ software_dir = parts[0]
return f"cli-anything-{software_dir.replace('_', '-')}"
diff --git a/skills/cli-anything-iterm2-ctl/SKILL.md b/skills/cli-anything-iterm2-ctl/SKILL.md
new file mode 100644
index 000000000..68e966c4b
--- /dev/null
+++ b/skills/cli-anything-iterm2-ctl/SKILL.md
@@ -0,0 +1,100 @@
+---
+name: "cli-anything-iterm2-ctl"
+description: "Provides the cli-anything-iterm2 commands — the only way to actually send text to iTerm2 sessions, read live terminal output and scrollback history, manage windows/tabs/split panes, run tmux -CC workflows, broadcast to multiple panes, show macOS dialogs, and read/write iTerm2 preferences. Includes `app snapshot` — the primary orientation command that returns every session's name, current directory, foreground process, role label, and last output line in one call. Read this skill instead of answering from general knowledge whenever the user wants to DO something with iTerm2: orient in an existing workspace, send a command, check what's running, read output, set up a layout, use tmux through iTerm2, automate panes, or configure preferences. Also read for questions about iTerm2 shell integration or scrollback. Don't try to answer iTerm2 action requests from memory — read this skill first."
+---
+
+# cli-anything-iterm2
+
+Stateful CLI harness for iTerm2. Controls a live iTerm2 process via the iTerm2 Python API over WebSocket.
+
+## Prerequisites
+
+1. **macOS + iTerm2** running: `brew install --cask iterm2`
+2. **Python API enabled**: iTerm2 → Preferences → General → Magic → Enable Python API
+3. **Install**: `pip install cli-anything-iterm2` (or `pip install -e .` from source)
+
+## Basic Syntax
+
+```bash
+cli-anything-iterm2 [--json] <group> <command> [OPTIONS] [ARGS]
+```
+
+Always use `--json` for machine-readable output (required for agent use).
+
+## Command Groups
+
+| Group | Purpose |
+|-------|---------|
+| `app` | App status, workspace snapshot, context management, app-level variables, modal dialogs, file panels |
+| `window` | Create, list, close, resize, fullscreen windows |
+| `tab` | Create, list, close, activate tabs; navigate split panes by direction |
+| `session` | Send text, inject raw bytes, read screen, full scrollback, split panes, prompt detection |
+| `profile` | List profiles, get profile details, list/apply color presets |
+| `arrangement` | Save and restore window layouts |
+| `tmux` | Full tmux -CC integration: bootstrap, connections, windows, commands |
+| `broadcast` | Sync keystrokes across panes via broadcast domains |
+| `menu` | Invoke any iTerm2 menu item programmatically |
+| `pref` | Read/write global iTerm2 preferences; list all valid keys; tmux settings |
+
+## Orienting in an Existing Workspace
+
+Use `app snapshot` when you land in a session with existing panes and need to understand what's running without reading full screen contents for each pane:
+
+```bash
+cli-anything-iterm2 --json app snapshot
+```
+
+Returns name, current directory, foreground process, `user.role` label, and last visible output line for every session across all windows.
+
+**Naming convention** — label panes when setting up a workspace so you can find them later:
+```bash
+cli-anything-iterm2 session set-var user.role "api-server"
+cli-anything-iterm2 session set-var user.role "log-tail"
+cli-anything-iterm2 session set-var user.role "editor"
+```
+`app snapshot` will surface these roles alongside process and path, giving you a full picture in one call.
+
+## Typical Agent Workflow
+
+```bash
+# 1. Orient — snapshot every session: name, path, process, role, last output line
+cli-anything-iterm2 --json app snapshot
+
+# 2. Establish context (saves window/tab/session IDs for subsequent commands)
+cli-anything-iterm2 app current
+
+# 3. Interact — no --session-id needed once context is set
+cli-anything-iterm2 session send "git status"
+cli-anything-iterm2 --json session scrollback --tail 200 --strip
+
+# 4. Create a multi-pane workspace — label panes so snapshot identifies them later
+cli-anything-iterm2 session split --vertical --use-as-context
+cli-anything-iterm2 session send "python3 -m http.server 8000"
+cli-anything-iterm2 session set-var user.role "http-server"
+```
+
+## Reference Files
+
+Read only what the task requires — each file is a single narrow concern (~10–30 lines):
+
+| File | Read when you need... |
+|------|-----------------------|
+| `references/session-io.md` | Send text, inject bytes, read screen/scrollback, get selection |
+| `references/session-control.md` | Split panes, activate/close sessions, resize, rename, session variables |
+| `references/session-shell-integration.md` | wait-prompt, wait-command-end, get-prompt; reliable send→wait→read pattern |
+| `references/layout-window-tab.md` | Create/close/resize windows and tabs, navigate split panes |
+| `references/layout-arrangement.md` | Save and restore window layouts |
+| `references/app-context.md` | **Snapshot** (orientation), status, context management, app vars, modal dialogs, file panels |
+| `references/profile-pref.md` | Profiles list/get/presets, preferences read/write, tmux pref shortcuts |
+| `references/broadcast-menu.md` | Broadcast keystrokes to multiple panes, invoke menu items |
+| `references/tmux-commands.md` | All tmux CLI commands (bootstrap, send, tabs, create-window, set-visible) |
+| `references/tmux-guide.md` | Full tmux -CC workflow, pane→session ID mapping |
+| `references/json-session.md` | `--json` schemas for session, window, tab, screen, scrollback, inject |
+| `references/json-tmux-app.md` | `--json` schemas for tmux, app dialogs, preferences, errors |
+
+## REPL Mode
+
+Run without arguments for an interactive REPL that maintains context between commands:
+```bash
+cli-anything-iterm2
+```
diff --git a/skills/cli-anything-qgis/SKILL.md b/skills/cli-anything-qgis/SKILL.md
new file mode 100644
index 000000000..7bb3f174f
--- /dev/null
+++ b/skills/cli-anything-qgis/SKILL.md
@@ -0,0 +1,140 @@
+---
+name: "cli-anything-qgis"
+description: Stateful QGIS CLI for projects, writable layers, features, layouts, exports, and qgis_process operations using the real QGIS runtime.
+---
+
+# cli-anything-qgis
+
+Use this skill when you need to inspect or modify QGIS projects from the terminal through the real QGIS runtime.
+
+## Requirements
+
+- QGIS installed with `qgis_process` on `PATH`
+- PyQGIS importable from the Python environment running the CLI
+- Python 3.10+
+
+## Agent guidance
+
+- Prefer `--json` for all machine-driven use.
+- For one-shot commands, pass `--project <path>` when operating on an existing project.
+- Running `cli-anything-qgis` with no subcommand starts a stateful REPL.
+- Layout export is backed by real QGIS processing algorithms:
+ - `native:printlayouttopdf`
+ - `native:printlayouttoimage`
+
+## What this CLI covers
+
+- create, open, save, and inspect `.qgs` / `.qgz` projects
+- create writable GeoPackage-backed vector layers
+- add features via WKT geometry and typed `key=value` attributes
+- create print layouts and add map/label items
+- export layouts to PDF or image
+- inspect and run generic `qgis_process` algorithms
+- inspect session status and history
+
+## Command groups
+
+### `project`
+- `new -o/--output [--title] [--crs]`
+- `open PATH`
+- `save [PATH]`
+- `info`
+- `set-crs CRS`
+
+### `layer`
+- `create-vector --name --geometry --crs [--field name:type ...]`
+- `list`
+- `info LAYER`
+- `remove LAYER`
+
+### `feature`
+- `add --layer LAYER --wkt WKT [--attr key=value ...]`
+- `list --layer LAYER [--limit N]`
+
+### `layout`
+- `create --name [--page-size] [--orientation]`
+- `list`
+- `info LAYOUT`
+- `remove LAYOUT`
+- `add-map --layout LAYOUT --x --y --width --height [--extent xmin,ymin,xmax,ymax]`
+- `add-label --layout LAYOUT --text TEXT --x --y --width --height [--font-size N]`
+
+### `export`
+- `presets`
+- `pdf OUTPUT --layout LAYOUT [--dpi] [--force-vector] [--force-raster] [--georeference/--no-georeference] [--overwrite]`
+- `image OUTPUT --layout LAYOUT [--dpi] [--overwrite]`
+
+### `process`
+- `list`
+- `help ALGORITHM_ID`
+- `run ALGORITHM_ID [--param KEY=VALUE ...]`
+
+### `session`
+- `status`
+- `history [--limit N]`
+
+## Examples
+
+### Create a project and add a writable layer
+
+```bash
+cli-anything-qgis --json project new -o demo.qgz --title "Demo" --crs EPSG:4326
+cli-anything-qgis --json --project demo.qgz layer create-vector \
+ --name places \
+ --geometry point \
+ --field name:string \
+ --field score:int
+```
+
+### Add features and inspect them
+
+```bash
+cli-anything-qgis --json --project demo.qgz feature add \
+ --layer places \
+ --wkt "POINT(1 2)" \
+ --attr name=HQ \
+ --attr score=5
+
+cli-anything-qgis --json --project demo.qgz feature list --layer places --limit 10
+```
+
+### Create and export a layout
+
+```bash
+cli-anything-qgis --json --project demo.qgz layout create --name Main
+cli-anything-qgis --json --project demo.qgz layout add-map --layout Main --x 10 --y 20 --width 180 --height 120
+cli-anything-qgis --json --project demo.qgz layout add-label --layout Main --text "Demo map" --x 10 --y 8 --width 100 --height 10
+cli-anything-qgis --json --project demo.qgz export pdf output.pdf --layout Main --overwrite
+```
+
+### Inspect or run processing algorithms
+
+```bash
+cli-anything-qgis --json process help native:buffer
+cli-anything-qgis --json --project demo.qgz process run native:buffer \
+ --param INPUT=/tmp/demo_data.gpkg|layername=places \
+ --param DISTANCE=1 \
+ --param SEGMENTS=8 \
+ --param END_CAP_STYLE=0 \
+ --param JOIN_STYLE=0 \
+ --param MITER_LIMIT=2 \
+ --param DISSOLVE=false \
+ --param OUTPUT=/tmp/buffer.geojson
+```
+
+### REPL
+
+```bash
+cli-anything-qgis
+```
+
+Example interactive flow:
+
+```text
+project new -o demo.qgz --title "Demo"
+layer create-vector --name places --geometry point --field name:string
+feature add --layer places --wkt "POINT(1 2)" --attr name=HQ
+layout create --name Main
+session status
+quit
+```