cli-anything-live2d — Claude Code skill: setup and features
cli-anything-live2d provides 42 terminal commands to inspect, edit, lint, and deploy Live2D Cubism models without running Live2D Editor.
Apache-2.0 299 installs ★ 62,125 updated 2026-09-22
npx skills add HKUDS/CLI-Anything --skill cli-anything-live2d -a claude-codeWhat cli-anything-live2d does
The tool manages .model3.json files directly from the command line. It covers 42 operations across inspection, editing, batch processing, and deployment. You do not need the proprietary Live2D Editor installed.
The utility splits into distinct functional areas. Inspection commands check file references, motion fade times, and dependency graphs. Analysis tools flag unreferenced files with orphan or test runtime compatibility with Web SDK. Generation helpers can scaffold new model templates or skeleton .motion3.json files.
Every edit command creates an automatic backup. Broken changes revert via undo, protecting source files during batch migrations. All inspection commands output JSON with the --json flag.
What it helps with
- verify that all referenced files in a Cubism model exist
- find unreferenced texture and motion assets
- batch-replace texture paths without manual JSON edits
- check model compatibility with Web SDK and Cubism Viewer
- prepare and package model directories for deployment
Example prompts for the agent
- Audit
character.model3.jsonwith best-practice checks and list any orphan files. - Update the idle motion fade-in duration to 0.3 in
character.model3.json. - Flatten the directory structure of
character.model3.jsoninto./deploy/for publishing.
How to install cli-anything-live2d
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-live2d -a claude-code2Manually: put the files in place
~/.claude/skills/cli-anything-live2d/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-anything-live2d/
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-live2d -a codex2Manually: put the files in place
.agents/skills/cli-anything-live2d/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-live2d -a cursor2Manually: put the files in place
.cursor/skills/cli-anything-live2d/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install HKUDS/CLI-Anything skills/cli-anything-live2d2Manually: put the files in place
.github/skills/cli-anything-live2d/SKILL.md1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-live2d -a gemini-cli2Platform CLI
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-live2dManually: put the files in place
.devin/skills/cli-anything-live2d/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-live2d -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cli-anything-live2d
How do I install cli-anything-live2d in Claude Code?
Run npx skills add HKUDS/CLI-Anything --skill cli-anything-live2d -a claude-code. The skill file will be placed at ~/.claude/skills/cli-anything-live2d/SKILL.md.
What is cli-anything-live2d used for?
It provides 42 terminal commands to inspect, edit, lint, and deploy Live2D Cubism assets. You can manage .model3.json files and motion presets without opening the Live2D Editor.
How does the tool protect files during edits?
Every modifying command creates an automated backup before writing changes. If an edit corrupts data, you can revert immediately using undo.
Source text
SKILL.md · Apache-2.0
---
name: "cli-anything-live2d"
description: "Inspect, validate, edit, lint, diff, batch-manage, and deploy Live2D Cubism models (.model3.json) from the command line."
metadata: { "cli-anything": { "category": "graphics", "requires": null } }
---
# cli-anything-live2d
Full-featured CLI for Live2D Cubism models. 42 commands covering inspection,
editing, linting, diffing, batch operations, asset management, generation,
and deployment — all without the Live2D Editor.
## Commands (42 total)
### Read (18)
| Command | Purpose |
|---------|---------|
| `inspect <model>` | Model overview (version, counts, features) |
| `validate <model>` | Check all referenced files exist |
| `motions <model>` | List motions with fade times |
| `motion-info <file>` | Detailed motion analysis |
| `expressions <model>` | List expression presets |
| `expr-info <file>` | Detailed expression analysis |
| `textures <model>` | List textures with dimensions and sizes |
| `physics <file>` | Physics simulation config |
| `moc3 <file>` | Moc3 binary info |
| `params <model>` | Parameter groups |
| `param-list <model>` | All params across motions/expressions |
| `deps <model>` | Dependency graph |
| `compare <a> <b>` | Quick comparison |
| `diff <a> <b>` | Detailed diff |
| `scan <dir>` | Find all models in directory |
| `export <model>` | Export as JSON/CSV |
| `stats <dir>` | Project overview |
| `manifest <model>` | File inventory with SHA256 checksums |
### Edit (10, all auto-backup)
| Command | Purpose |
|---------|---------|
| `edit-motion` | Edit motion fade times or file path |
| `add-motion` | Add motion to group |
| `rm-motion` | Remove motion |
| `add-expr` | Add expression |
| `rm-expr` | Remove expression |
| `edit-texture` | Replace texture path |
| `edit-model` | Edit moc3/physics/pose/userdata |
| `param-edit` | Edit parameter value in .exp3.json |
| `rename-group` | Rename a motion group |
| `find-replace` | Batch rename file references |
### Generation (3)
| Command | Purpose |
|---------|---------|
| `init` | Generate full model template |
| `gen-motion` | Generate skeleton .motion3.json |
| `gen-expr` | Generate skeleton .exp3.json |
### Analysis (4)
| Command | Purpose |
|---------|---------|
| `lint` | Best practice checks |
| `runtime-check` | Cubism Viewer / Web SDK / Yoyo compatibility |
| `atlas` | Texture atlas analysis |
| `orphan` | Find unreferenced files |
### Workflow (7)
| Command | Purpose |
|---------|---------|
| `undo` | Restore from auto-backup |
| `backup-clean` | Rotate old backups |
| `restore-file` | Restore specific file from backup |
| `batch` | Batch-edit multiple models |
| `snapshot` | Generate HTML preview |
| `watch` | Auto-validate on file changes |
| `flatten` | Flatten directory for deployment |
### Other (3)
| Command | Purpose |
|---------|---------|
| `migrate` | Model format version upgrade |
| `pack` | Package model + deps into zip |
| `yoyo-check` | Yoyo desktop-pet readiness |
All read commands support `--json`. Edit commands auto-backup.
## Examples
```bash
cli-anything-live2d inspect model.model3.json
cli-anything-live2d lint model.model3.json --level info
cli-anything-live2d edit-motion model.model3.json -g Idle -i 0 --fade-in 0.3
cli-anything-live2d find-replace model.model3.json -f "old_tex" -f "new_tex"
cli-anything-live2d orphan model.model3.json
cli-anything-live2d runtime-check model.model3.json --target web-sdk
cli-anything-live2d flatten model.model3.json --out-dir ./deploy/
cli-anything-live2d batch ./models/ --set-fade-in 0.3 --dry-run
cli-anything-live2d snapshot model.model3.json --embed
cli-anything-live2d stats ./project/
```
© HKUDS · Apache-2.0 · HKUDS/CLI-Anything