Amahane Hikari Live2D skill

A skill for Live2D projects: from layers and Cubism rigging to browser acceptance and rollback, with code and a sample model.

  • 115 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • The skill runs verification scripts and writes project files; external publishing happens only within the user permissions.
All reasons and checks

luomo66ccff/amahane-hikari-live2d

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/amahane-hikari-live2d

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The skill runs verification scripts and writes project files; external publishing happens only within the user permissions.

This is third-party code. Review the repository files before installing.

What it does

The Amahane Hikari repository is built around the `live2d-end-to-end` skill: it describes the path from a fixed character and layers to a Live2D Cubism model, a web page and a safe release. According to the authors, a generated picture or a web animation does not replace a finished model. The work uses three references. The first, art-to-cubism, leads from locking the look through Photoshop checks, import, masks, meshes and deformers to parameters and export. The second, runtime-and-acceptance, matches runtime parameters, checks Core and visuals, and covers web controls. The third, release-and-recovery, covers page caching, licenses, the version manifest and rollback. Alongside sit TypeScript code for a WebGL page, tools for motion control and resource release, and the model sources. The skill is published as a separate package.

Who it is for. Artists and developers who build Live2D characters for the web and want a reproducible process with checks at every step.

Good fit when

  • You need to run a project from scratch, from character requirements to a model and a checked page.
  • A page with a model loads slowly and you need resource release and texture preparation techniques.
  • You must pass acceptance: save, close, reopen, export and read the model through the real Core.
  • You need a release rollback plan with a version manifest.

Not a fit when

  • You need a ready model without building it yourself.
  • You have no Live2D Cubism Editor or Photoshop for the steps the skill requires there.
  • The goal is animation without Live2D, such as sprites or Spine.

Example request

Run acceptance for the Hikari Live2D model: save, reopen the project, export and match parameters in the browser.

Limitations

The skill is tailored to the Hikari project, and other characters need the steps adapted. Rigging needs Live2D Cubism Editor and Photoshop, which the skill neither replaces nor ships. The Cubism SDK, PSD files and raw logs are not part of the public package. Licenses differ: runtime code is MIT, texts and the skill are CC BY 4.0 with attribution, and the model has separate terms. Most documentation is written in Chinese.

How to disable. Delete the `live2d-end-to-end` skill folder from the agent skills directory. Project and model files stay in your repository.

FAQ

Where do I get the skill without the project?

Release v2.0.1 of the repository holds a skill-only package. The source is in the `skills/live2d-end-to-end` folder.

What does the skill check before release?

Saving, reopening and exporting the Cubism project, reading the model through the real Core and a visual review. Parameter names and screenshots count only as hints.

Can I use the model in my own project?

The model has separate terms, so read `LICENSES` and `THIRD_PARTY_NOTICES.md` in the repository before using it.

Is Photoshop required?

Yes, for layer acceptance: real alpha, edges, registration, occlusion and layer splitting are checked there before import into Cubism.

How are checks run without the Cubism SDK?

The repository has SDK-free regression checks that run in GitHub Actions; the browser part needs Chromium from `npx playwright install chromium`.

Discussion

No questions or reviews yet.

Skills

A skill rebuilds the object in a reference image as a procedural Three.js model written in code, not downloaded art

SkillMinimal access21.3KRepository stars

A skill and tools for Codex that turn a reference or layered PSD into a working Live2D model with checks and a web preview.

SkillExtended access52Repository stars

A skill that draws interactive isometric illustrations in SVG, with WebGL shaders and React output, explaining an idea as a working machine

SkillExtended access26.9KRepository stars

A Claude skill for story animations drawn live in the browser by code: watercolor, ink wash, scroll and night-book styles.

SkillMinimal access128Repository stars

A skill that turns a topic into a short animated card with facts from found sources and Live Photo assets for the iPhone

SkillExtended access553Repository stars

A skill that takes an agent from a generated picture to a game asset: sprites, video-to-frames animation and pre-release checks

SkillExtended access306Repository stars

README in short

The project shows how an AI agent carries creative work under human control: the agent breaks down tasks and writes code, tests and docs, while the maintainer accepts the result. The repository collects the evidence.

README badge

Original SKILL.md

---
name: live2d-end-to-end
description: 从角色需求、候选素材和真实分层开始,完成 Live2D Cubism 绑定、动态、网页验收与可回退发布;适用于 Hikari 类项目,不把生成图或网页动画冒充已完成的模型编辑。
metadata:
  short-description: Hikari Live2D 从美术到发布的可验证流程
---

# Live2D 端到端制作

在需要从零整理或继续制作 Hikari Live2D 时使用本技能。目标是得到可编辑、可复现、可核验的源工程、运行包和网页交付;已有美术不强制重新生成,缺失结构才补候选。

先锁定角色身份、风格、参考图和允许的变更范围,再决定复用、局部补绘或生成候选。生成候选只能进入候选区;必须在 Photoshop 中验证真实 Alpha、边缘、配准、遮挡和拆层,并完成保存、重开、三底色和有限错位检查后,才允许进入 Cubism。候选生成不能被描述为一键完成。

从零项目在 Cubism 中从受控 PSD 新建;续作先核验并复用已有已验收 CMO3,只有材料或绑定确有变更时才重新导入。无论入口为何,都记录真实 ArtMesh、遮罩、绘制顺序、网格、变形器和参数 ID,并以中性态为回退点逐项绑定。头部体积要由 Head/Face 的真实局部形变和颈部补偿建立,嘴、眼、肩袖、饰品要能在组合姿态中连续。Q 弹层级可让视线、头部、身体和发饰分层跟随,手臂保持肩根到袖端的自然连接与小幅轻摆;不能用整脸缩放、整臂平移或高频同相物理替代。

进入 Cubism 编辑器源工程的里程碑时执行保存—关闭—重开—导出,并以真实 Core 读回和人工视觉检查共同验收;纸面需求和候选材料阶段只做版本化记录,不要求导出。参数名、JSON、截图或枚举到 ID 只能算线索;未绑定、未读回、未查看连续运动的项目标为待验或未验证。动作需有开始、保持、结束、复位、打断和重入,网页的口型、动作、物理和暂停必须有明确所有权。

按需读取参考:

- [美术到 Cubism](references/art-to-cubism.md):需求锁定、候选、真实 Alpha、Photoshop 门禁、导入、遮罩、网格、变形器、关键形、物理、表情与导出。
- [运行时与验收](references/runtime-and-acceptance.md):实际参数映射、Q 弹与手臂、Core 加视觉证据、网页控制、VTube Studio 独立边界。
- [发布与恢复](references/release-and-recovery.md):网页缓存、许可、版本清单、回退和具体失败纠正。

只在当前用户已授权的范围内执行外部发布,并在写入前核验目标身份;不要在脚本、文案或配置中硬编码个人账号、私网地址或凭据。公开技能包只含文档和可移植验证脚本,不打包模型、PSD、Cubism SDK 或原始日志。文档按 CC BY 4.0 发布,`scripts/` 下的新脚本按 MIT 发布。

Report a problem