swiss-knife

Swiss Knife — Utility Toolkit Router

Swiss Knife is a top-level router for small, focused utility references. Enter through this file, choose exactly one nested reference from the catalog below, then read that nested SKILL.md for the actual procedure, examples, scripts, and assets.

Nested reference catalog

nested_references:
  - name: bash-cli-harnesses
    # Virtual cross-skill redirect, not a local reference/<name>/SKILL.md file.
    location: bash-manual reference/bash-*/SKILL.md
    description: >
      Coding-agent CLIs such as Claude Code, OpenAI Codex, OpenCode, Cursor
      Agent, MiMo Code, Qwen Code, Oh-My-Pi, Gemini CLI, Aider, Goose,
      OpenHands, and Crush are now owned by `bash-manual` because they run as
      long-lived shell subprocesses. Read `bash-manual` and then the matching
      nested `reference/bash-*/SKILL.md`; Swiss Knife only keeps non-bash utility
      references.
  - name: minimax-cli
    location: reference/minimax-cli/SKILL.md
    description: >
      Nested swiss-knife reference for the MiniMax `mmx` CLI. Read this for
      MiniMax-backed image, video, music, TTS, or ad-hoc shell vision tasks.
  - name: vision
    location: reference/vision/SKILL.md
    description: >
      Nested swiss-knife reference for image understanding. Read this when you
      need to describe, OCR, or critique an image and aren't sure which path
      applies — it routes between the built-in `vision` tool, the sibling
      `minimax-cli` reference, and a local Hugging Face VLM fallback.
  - name: listen
    location: reference/listen/SKILL.md
    description: >
      Nested swiss-knife reference for local audio analysis. Read this when the
      human asks you to transcribe a voice note, extract lyrics, critique
      generated music, or measure audio characteristics — all local, no API key
      (Whisper transcription and librosa music analysis).
  - name: academic-research
    location: reference/academic-research/SKILL.md
    description: >
      Nested swiss-knife reference for academic literature work. Read this to
      fetch full-text papers by DOI/arXiv-ID/PMID, trace citation networks, run
      scholar analysis, or write/compile LaTeX manuscripts — indexes 12 API
      references and 6 pipeline workflows.
  - name: dj
    location: reference/dj/SKILL.md
    description: >
      Nested swiss-knife reference for composing one music track from a project
      journal entry. Read this when the human asks for music for a journal day,
      project vibe, session mood, or a specific generated genre.
  - name: token-usage
    location: reference/token-usage/SKILL.md
    description: >
      Nested swiss-knife reference for network-wide token, cost, cache, and tool-call/API-call trend reports. Read
      this when the human asks about token usage, budget, model costs, spending, cache behavior, or tools per API call
      across agent ledgers.
  - name: html-report
    location: reference/html-report/SKILL.md
    description: >
      Nested swiss-knife reference for standalone HTML deliverables. Read this
      when the human asks for a polished browser-openable report, dashboard,
      memo, comparison, or any HTML artifact with MathJax equations.
  - name: xiaomi-mimo
    location: reference/xiaomi-mimo/SKILL.md
    description: >
      Nested swiss-knife reference for Xiaomi MiMo provider discovery. Read this
      when the human asks to use or configure Xiaomi MiMo / 小米MiMo, or when you
      need to understand the MiMo model family and compatible endpoints.
  - name: zhipu-coding-plan
    location: reference/zhipu-coding-plan/SKILL.md
    description: >
      Nested swiss-knife reference for the Zhipu / Z.AI / BigModel coding-plan
      subscription. Read this when the human asks about Zhipu credentials or the
      plan's vision, web search, web-read, and zread MCP capabilities.
  - name: headless-bot
    location: reference/headless-bot/SKILL.md
    description: >
      Nested swiss-knife reference for creating and operating headless LingTai
      bot projects from `lingtai-tui spawn`. The current helper provisions a
      Telegram MCP bot, and the workflow also covers preset-policy replication,
      addon wiring, secret hygiene, refresh/relaunch, and verification.
  - name: find-something-to-do
    location: reference/find-something-to-do/SKILL.md
    description: >
      Nested swiss-knife reference for idle curiosity practice. Read this when
      you have no pending task, no human waiting, and want a reflective way to
      notice quiet impulses or choose a small autonomous exploration.
  - name: preset-health
    location: reference/preset-health/SKILL.md
    description: >
      Nested swiss-knife reference for read-only saved-preset health checks.
      Read this when the human asks whether saved presets still work, which one
      is expired or misconfigured, or why `system(action="presets")` shows a bad
      connectivity status. It enumerates saved presets, classifies failures
      (expired key, missing credentials, unreachable endpoint, invalid
      model/config, connectivity failure), and reports actionable fixes without
      printing or mutating any secret.