lattifai-skills

lattifai-skills

Audio-text alignment, transcription, translation, karaoke, and subtitle toolkit for Claude Code — and also installable in OpenAI Codex CLI and Gemini CLI. Powered by the LattifAI Lattice-1 forced-alignment model.

English | 中文

Each skill follows the Agent Skills standard — a self-contained SKILL.md per capability that any compatible agent can discover and load. Verified install paths for Claude Code, Codex CLI, and Gemini CLI are documented below.

9 composable skills cover the full pipeline from a raw YouTube URL to multilingual, per-word-highlighted, production-grade captions.

---

Installation

Pick the flow that matches your agent.

Option A — Claude Code (/plugin marketplace)

This repo ships both a plugin manifest and a plugin marketplace at the root. Inside any Claude Code session:

/plugin marketplace add lattifai/lattifai-skills
/plugin install lattifai-skills@lattifai-skills
/reload-plugins

Or non-interactively:

claude plugin marketplace add lattifai/lattifai-skills
claude plugin install lattifai-skills@lattifai-skills

All skills become available under the plugin namespace:

/lattifai-skills:lai-karaoke https://youtu.be/VIDEO_ID

Option B — OpenAI Codex CLI (codex plugin marketplace)

Codex CLI accepts the same <owner>/<repo> source format and reads the .claude-plugin/marketplace.json at the repo root, so registration is one command:

codex plugin marketplace add lattifai/lattifai-skills

The marketplace is registered in ~/.codex/config.toml and skills become available in your next Codex session — no separate install step.

Option C — Gemini CLI (gemini skills install)

Gemini CLI installs skills directly from a git URL. Because the skills live under skills/<name>/SKILL.md (not at the repo root), pass --path skills to install all 9 in one call:

# Install all 9 skills from the bundle
gemini skills install https://github.com/lattifai/lattifai-skills --path skills

# Or for live development against a local checkout (auto-reloads on edit)
git clone https://github.com/lattifai/lattifai-skills.git
gemini skills link ./lattifai-skills/skills

Option D — Any other agent (drop-in SKILL.md directory)

Each skills/<name>/ directory is a self-contained skill following the Agent Skills standard — copy whichever ones you want to wherever your agent watches:

git clone https://github.com/lattifai/lattifai-skills.git
mkdir -p .claude/skills && cp -r lattifai-skills/skills/lai-karaoke .claude/skills/

Common destinations:

Agent	Drop-in path
Claude Code (project)	.claude/skills/<name>/SKILL.md
Claude Code (personal)	~/.claude/skills/<name>/SKILL.md
Cursor / Continue / custom agents	wherever your agent loads skills from

Edits to .claude/skills/ are picked up live within the current Claude Code session — no reload command needed. Other agents follow their own conventions (/reload-plugins in CC for plugin-dir / marketplace sources; gemini skills enable/disable for Gemini; restart for agents without hot-reload).

Update

# Claude Code:
/plugin marketplace update lattifai-skills
# Codex CLI:
codex plugin marketplace upgrade lattifai-skills
# Gemini CLI:
gemini skills install https://github.com/lattifai/lattifai-skills --path skills

---

Requirements

Different skills have different dependencies — install what you need.

Important: the lattifai package depends on lattifai-core, which is hosted on the LattifAI PyPI mirror. Always include --extra-index-url https://lattifai.github.io/pypi/simple/ when installing.

# pip (default, takes 5–15 min on first install)
pip install "lattifai[all]" --extra-index-url https://lattifai.github.io/pypi/simple/

# uv — recommended for ~10–15× faster install (≈1 min on broadband)
uv pip install "lattifai[all]" --extra-index-url https://lattifai.github.io/pypi/simple/
uv pip install --reinstall-package lattifai "lattifai[all]" \
    --extra-index-url https://lattifai.github.io/pypi/simple/
# (The second uv command is a workaround for a known entry-point name
#  conflict — re-installs lattifai last so its `lai` console script wins.
#  See `/lai-setup` for details.)