/cli-anything-generator

name: cli-anything-generator
description: >-
  Build, refine, test, validate, or list CLI-Anything harnesses for GUI
  applications in Cursor. Prefer slash commands /cli-anything,
  /cli-anything-refine, /cli-anything-test, /cli-anything-validate, and
  /cli-anything-list when available. This skill supports natural-language
  discovery of the generator; it does not replace those commands. Discovering
  already-published CLIs from CLI-Hub is a separate consumer skill
  (cli-hub-meta-skill).

CLI-Anything Generator (Cursor Plugin Skill)

This skill is packaged **inside the Cursor plugin** as a supporting entry point. The primary generator UX is the plugin slash commands.

Prefer Slash Commands

| Goal | Command | |------|---------| | Full 7-phase build | `/cli-anything <path-or-repo>` | | Expand coverage | `/cli-anything-refine <path> [focus]` | | Run tests | `/cli-anything-test <path>` | | Validate checklist | `/cli-anything-validate <path>` | | List tools | `/cli-anything-list` |

If the user speaks naturally ("build a CLI for ./gimp"), run the same workflow as the matching command.

Consumer Path (Separate)

This skill is **not** the Hub consumer. For finding/installing published CLIs:

npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y

Per-app skills live under the repo `skills/` tree and install via `npx skills add`.

PLUGIN_ROOT and Methodology

1. Resolve `PLUGIN_ROOT` via discovery pointer then stamp:

• `~/.cursor/cli-anything-generator.root` / `%USERPROFILE%\.cursor\cli-anything-generator.root`
• `{install}/PLUGIN_ROOT.txt`
• default `~/.cursor/plugins/local/cli-anything` if `references/HARNESS.md` exists there

2. Read `{PLUGIN_ROOT}/references/HARNESS.md` with an absolute path. 3. Read the matching file under `{PLUGIN_ROOT}/references/commands/`. 4. Use guides under `{PLUGIN_ROOT}/references/guides/` on demand. 5. Helper scripts: `{PLUGIN_ROOT}/scripts/repl_skin.py`, `preview_bundle.py`, `skill_generator.py`, `templates/`.

Path remapping (from HARNESS / plugin docs)

| Document reference | Installed plugin path | |--------------------|----------------------| | `guides/...` | `references/guides/...` | | `cli-anything-plugin/repl_skin.py` | `scripts/repl_skin.py` | | `cli-anything-plugin/preview_bundle.py` | `scripts/preview_bundle.py` | | `cli-anything-plugin/skill_generator.py` | `scripts/skill_generator.py` | | `templates/SKILL.md.template` | `scripts/templates/SKILL.md.template` | | `docs/PREVIEW_PROTOCOL.md` | `references/docs/PREVIEW_PROTOCOL.md` |

Cursor Tool Bindings

| Cursor tool | Role | |-------------|------| | Read | Methodology and source analysis | | Grep / Glob | API and file discovery | | Shell | Clone, pytest, pip, CLI invocation | | Write / StrReplace | Harness implementation | | Task | Optional parallel subtasks |

Phase Gates

For build/refine/test/validate, maintain `{software-root}/agent-harness/.cli-anything-progress.json`. Create `agent-harness/` when tracking starts. Do not advance without completing the previous phase. Resume non-terminal runs.

Quality Bar

Match Claude Code plugin / Codex skill output: same harness layout, namespace packaging, `--json`, tests, and skill generation. Do not invent a different harness format.