New to Claude Skills? Learn how to install them →

Chkuds on GitHub

CLI for Live2D Models

Free

Command line management for Live2D Cubism models.

by hkuds46.9k stars on hkuds/cli-anything
13 views
Updated Aug 3, 2026
Get this skill

Free · Opens the source repo

What CLI for Live2D Models does

The cli-anything-live2d skill provides a comprehensive command line interface (CLI) for managing Live2D Cubism models, specifically targeting users who prefer working outside the graphical Live2D Editor. With 42 available commands, this tool allows developers and designers to inspect, validate, edit, lint, and deploy models directly from the terminal. This capability is particularly useful for batch operations and asset management, streamlining workflows that involve multiple models.

Users can perform a variety of tasks, such as checking the integrity of model files, editing motion and expression parameters, and generating model templates. The skill supports operations like linting for best practices and runtime checks for compatibility with various platforms. Furthermore, the CLI allows for efficient model comparison and detailed analysis of model components, ensuring that users can maintain high-quality standards in their projects.

Designed for developers and designers who work with Live2D models, this skill is ideal for those looking to automate repetitive tasks or manage large sets of models efficiently. The command line nature of the tool allows for quick execution of commands, which can significantly enhance productivity, especially in larger projects where graphical interfaces may become cumbersome.

Overall, cli-anything-live2d is an essential tool for anyone involved in the development or design of Live2D models, providing a powerful set of commands that facilitate a wide range of operations without needing the Live2D Editor.

When to use it

Use this tool when you need to manage, edit, or deploy Live2D models quickly from the command line, especially in batch operations.

When not to use it

This skill may not be suitable for users who prefer graphical interfaces or those who are unfamiliar with command line operations.

What you can build with it

Inspecting a Model

Quickly get an overview of a Live2D model's version, counts, and features with the `inspect` command.

Batch Editing

Use the `batch` command to apply changes across multiple models at once, saving time on repetitive tasks.

Validating Before Deployment

Run the `lint` and `runtime-check` commands to ensure your models are ready for deployment without errors.

How to install CLI for Live2D Models

View source

1. Install with the skills CLI

npx skills add hkuds/cli-anything/skills --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by hkuds

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)

CommandPurpose
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)

CommandPurpose
edit-motionEdit motion fade times or file path
add-motionAdd motion to group
rm-motionRemove motion
add-exprAdd expression
rm-exprRemove expression
edit-textureReplace texture path
edit-modelEdit moc3/physics/pose/userdata
param-editEdit parameter value in .exp3.json
rename-groupRename a motion group
find-replaceBatch rename file references

Generation (3)

CommandPurpose
initGenerate full model template
gen-motionGenerate skeleton .motion3.json
gen-exprGenerate skeleton .exp3.json

Analysis (4)

CommandPurpose
lintBest practice checks
runtime-checkCubism Viewer / Web SDK / Yoyo compatibility
atlasTexture atlas analysis
orphanFind unreferenced files

Workflow (7)

CommandPurpose
undoRestore from auto-backup
backup-cleanRotate old backups
restore-fileRestore specific file from backup
batchBatch-edit multiple models
snapshotGenerate HTML preview
watchAuto-validate on file changes
flattenFlatten directory for deployment

Other (3)

CommandPurpose
migrateModel format version upgrade
packPackage model + deps into zip
yoyo-checkYoyo desktop-pet readiness

All read commands support --json. Edit commands auto-backup.

Examples

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/

Frequently asked questions about CLI for Live2D Models

Similar skills