cli-anything-live2d

Inspect, edit, lint, and deploy Live2D Cubism model files from the command line.

48.8k|4.5k|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-live2d
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-anything-live2d
Source: https://github.com/HKUDS/CLI-Anything/tree/main/live2d/agent-harness/cli_anything/live2d/skills
Command: npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-live2d

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing Live2D Cubism models (.model3.json) normally requires the proprietary Live2D Editor, making it hard to validate, edit, batch-process, or deploy models in automated pipelines. This Skill provides 42 CLI commands covering the full model lifecycle without the editor.

Core Features & Use Cases

  • Inspection & Validation: Inspect model structure, validate referenced files, list motions/expressions/textures, analyze physics and moc3 binaries, and generate dependency graphs with SHA256 manifests.
  • Safe Editing with Auto-Backup: Edit motions, expressions, textures, and parameters with automatic backups, undo, restore, and batch operations across multiple models.
  • Linting & Deployment: Run best-practice lint checks, runtime compatibility checks (Cubism Viewer, Web SDK, Yoyo), find orphaned files, flatten directories, and package models into zips for deployment.
  • Use Case: A VTuber studio needs to update fade-in times across 50 character models and verify Web SDK compatibility before release. Run batch with --set-fade-in and runtime-check --target web-sdk to complete the task in one pass.

Quick Start

Ask the agent to inspect and lint your Live2D model file, for example: "Inspect model.model3.json and run lint checks at info level."

Frequently Asked Questions about cli-anything-live2d

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit Live2D model files without the Live2D Editor?

Use the CLI's edit commands such as edit-motion, add-expr, edit-texture, and param-edit to modify .model3.json, .motion3.json, and .exp3.json files directly. Every edit command creates an automatic backup, and you can roll back changes with the undo command.

How to batch edit multiple Live2D models at once?

Run the batch command against a directory of models, for example setting fade-in times across all models with a dry-run flag to preview changes first. This applies consistent edits without opening each model individually.

Does this tool check Live2D Web SDK compatibility?

Yes, the runtime-check command validates a model against specific targets including Cubism Viewer, Web SDK, and Yoyo desktop pets. It reports compatibility issues so you can fix them before deployment.

How do I find unreferenced files in a Live2D project?

Use the orphan command on a model to list files present in the project directory but not referenced by the model definition. The deps command also generates a full dependency graph for verification.

Can I compare two versions of a Live2D model?

Yes, the compare command gives a quick overview of differences between two models, while diff produces a detailed field-level comparison. Both work on .model3.json files directly.

What happens if an edit corrupts my Live2D model?

All edit commands create automatic backups before modifying files. Use undo to restore the last state, restore-file to recover a specific file, and backup-clean to rotate old backups.