cli-anything

Files (2)

• SKILL.md
• _meta.json

SKILL.md (first lines)

# CLI-Anything Skill

**Core rule: Do everything yourself. Never give the user a command to run. Never explain steps. Just execute the task and report the result.**

**Activation rule: The user does NOT need to say "CLI-Anything". If their task matches a supported app below, use it automatically — no prompting needed.**

---

## Task Routing — Auto-select the right app (check this before every task)

| If the user asks about... | Use this app | Command prefix |
|---|---|---|
| Resize / crop / filter / edit an image | **GIMP** | `cli-anything-gimp` |
| Convert image format (JPG→PNG, PNG→WEBP, etc.) | **GIMP** | `cli-anything-gimp` |
| SVG, vector graphics, logos | **Inkscape** | `cli-anything-inkscape` |
| Digital painting, .kra files | **Krita** | `cli-anything-krita` |
| Convert DOCX / XLSX / PPTX → PDF | **LibreOffice** | `cli-anything-libreoffice` |
| Writer / Calc / Impress / spreadsheet macros | **LibreOffice** | `cli-anything-libreoffice` |
| Trim / convert / export audio (MP3, WAV, FLAC) | **Audacity** | `cli-anything-audacity` |
| Render / edit video | **Kdenlive** or **Shotcut** | `cli-anything-kdenlive` |
| Record screen or live stream | **OBS Studio** | `cli-anything-obs` |
| 3D modeling / rendering / .blend files | **Blender** | `cli-anything-blender` |
| Create or export diagrams (.drawio) | **Draw.io** | `cli-anything-draw-io` |
| Render Mermaid diagram code | **Mermaid** | `cli-anything-mermaid` |
| Generate image from text prompt (AI) | **Stable Diffusion** or **ComfyUI** | `cli-anything-stable-diffusion` |
| Run a local LLM | **Ollama** | `cli-anything-ollama` |
| AI content generation | **AnyGen** | `cli-anything-anygen` |
| AI research / summarize PDF | **NotebookLM** | `cli-anything-notebooklm` |
| Execute a Jupyter notebook | **JupyterLab** | `cli-anything-jupyterlab` |
| CAD / 3D design, .fcstd files | **FreeCAD** | `cli-anything-freecad` |
| GIS / maps, .qgz files | **QGIS** | `cli-anything-qgis` |
| Monitoring dashboards | **Grafana** | `cli-anything-grafana` |
| Git hosting, create repos | **Gitea** or **GitLab** | `cli-anything-gitea` |
| CI/CD pipelines | **Jenkins** | `cli-anything-jenkins` |
| Cloud file sync | **NextCloud** | `cli-anything-nextcloud` |
| Network-wide ad blocking | **AdGuard Home** | `cli-anything-adguard-home` |
| Video conferencing | **Zoom** | `cli-anything-zoom` |
| Knowledge outlines | **Mubu** | `cli-anything-mubu` |

---

## Smart Fallback — When CLI-Anything fails

CLI-Anything is the first choice, but if it fails the agent must still complete the task:

1. **Try CLI-Anything first** — always attempt the harness (`cli-anything-<app>`)
2. **If harness fails after 1 retry** — fall back to Python (PIL, python-docx, pydub, moviepy, etc.) and complete the task anyway
3. **Always tell the user** what was actually used and suggest installing the app for better results

Example:
> "Done — resized using Python PIL as a fallback (GIMP harness failed). Install GIMP for higher quality results next time."

Never leave the user with no result. Always complete the task one way or another.

---

## FORBIDDEN — Never Do These (causes bugs on all platforms)

These patterns are strictly banned. If you catch yourself about to do any of these, stop and use the cli-anything harness instead.

| ❌ FORBIDDEN | ✅ CORRECT |
|---|---|
| `soffice.exe --headless --convert-to pdf ...` | `cli-anything-libreoffice convert doc.docx output.pdf` |
| `cd "C:\Program Files\LibreOffice\program" && soffice.exe ...` | `cli-anything-libreoffice convert doc.docx output.pdf` |
| `gimp --batch-interpreter=script-fu-use-v2 ...` | `cli-anything-gimp image resize input.jpg output.jpg 1920 1080` |
| `blender --background scene.blend --render-output ...` | `cli-anything-blender render scene.blend --output frames/ --format PNG` |
| `inkscape --export-type=png logo.svg` | `cli-anything-inkscape export logo.svg logo.png --dpi 300` |
| Chaining with `&&`: `cmd1 && cmd2` | Two separate `run_shell` calls |
| Any `.exe` extension in a command | No `.exe` — harness is cross-platform |
| Hardcoded paths like `C:\Program Files\...` | Use the harness — it finds the app automatically |

**Why these are banned:**
- `.exe` only exists on Windows — breaks on macOS and Linux
- `C:\Program Files\...` paths break on macOS and Linux
- `&&` chaining breaks in PowerShell on Windows
- Raw app CLIs require knowing app-specific flags — the harness handles all of that

---

## Help Response (no tools needed — just reply with text)

If the user's message matches any of these (case-insensitive, any wording):
- "cli anything help" / "cli-anything help" / "cli help"
- "what apps does cli-anything support" / "what can cli-anything do"
- "show cli apps" / "cli anything guide" / "list cli apps"
- Any variation asking what CLI-Anything can do or which apps are supported

**Do not run any tools. Reply directly with this message:**

---

**CLI-Anything — What I Can Do**

Just describe your task in plain English — you don't need to mention CLI-Anything. I'll pick the right app, install it if needed, and complete the task. Works on Windows, macOS, and Linux.

**Creative & Media**
| App | What I do | Example |
|---|---|---|
| GIMP _(image editing)_ | Resize, crop, filter, convert, export images | "Resize photo.jpg to 1920×1080" |
| Blender _(3D modeling & rendering)_ | Render scenes, export models, run scripts | "Render scene.blend to PNG frames" |
| Inkscape _(vector graphics)_ | Export SVG to PNG/PDF, convert vectors | "Export logo.svg as 300 DPI PNG" |
| Audacity _(audio production)_ | Trim, convert, export audio | "Trim first 30s from audio.mp3" |
| OBS Studio _(live streaming & recording)_ | Record screen, capture video, stream | "Record my screen for 60 seconds" |
| Kdenlive _(video editing)_ | Render video projects to MP4/MKV | "Render project.kdenlive to MP4" |
| Shotcut _(video editing)_ | Render video projects to MP4 | "Render project.mlt to MP4" |
| Krita _(digital painting)_ | Export paintings, batch convert .kra files | "Export painting.kra as PNG" |

**Office & Productivity**
| App | What I do | Example |
|---|---|---|
| LibreOffice _(Writer, Calc, Impress)_ | Convert DOCX/XLSX/PPTX to PDF, run macros | "Convert report.docx to PDF" |
| Mubu _(knowledge management & outlining)_ | Manage outlines and knowledge bases | "Open my outline in Mubu" |

**Communication**
| App | What I do | Example |
|---|---|---|
| Zoom _(video conferencing)_ | Start or join meetings | "Start a Zoom meeting" |

**Diagramming**

From CraftOS-dev/CraftBot, MIT.

More from CraftOS-dev/CraftBot