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: academic-research
    location: reference/academic-research/SKILL.md
    description: >
      Nested swiss-knife reference for citation and empirical evidence gates.
      Verify sources before drafting and anchor claims to data and runner code;
      no bundled paper-fetch scripts or API/pipeline cookbook.
  - 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: 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.

Routing table

How to use this router

1. Match the request to one row in the routing table.
2. Read the nested reference at the relative location next to this parent SKILL.md.
3. Follow that nested reference's procedure. Each nested reference owns its own scripts and assets under its folder.

Do not load every nested reference by default. Swiss Knife exists to avoid polluting working context with unrelated utility manuals.

Adding a nested utility reference

1. Create reference/<name>/SKILL.md with normal skill frontmatter (name, description, optional version/tags). The description should start with the fact that it is a nested swiss-knife reference and should state when to read it.
2. Put that reference's scripts/, assets/, and extra files under the same reference/<name>/ folder.
3. Add the child to the nested_references YAML block and routing table above.
4. Run validation/tests. At minimum, verify the parent mentions the child and the embedded TUI skill tree still copies every nested file.
5. Re-extract the embedded skill bundle to disk after installing/updating the TUI: the human runs lingtai-tui bootstrap, then agents call system(action="refresh") or skills(action="info") to see the refreshed utility tree.

Design philosophy

• Router first — Swiss Knife itself exposes swiss-knife/SKILL.md as its top-level catalog entry; its bundled references are reached through that router rather than promoted as sibling top-level utility skills or swiss-knife/<child> skills.
• Self-contained children — each nested reference carries its own examples, scripts, and assets.
• Single-purpose children — if a nested utility grows into a broadly useful workflow that agents should discover directly, promote it to a normal top-level skill instead of keeping it under Swiss Knife.
• Small working context — read one nested reference at a time.

Found a bug or issue? If you encounter any problems with this skill, load the lingtai-issue-report skill and follow its instructions to report it.