SkillsAdd

stvlynn/skills

pv-tool

Operate the bundled PV Tool kinetic typography web app for lyric videos, promotional videos, and motion-graphics text overlays.

First seen Mar 29, 2026

Installation

$ npx skills add stvlynn/skills --skill pv-tool
View on skills.sh ↗ GitHub repository ↗

Summary

  • Operate the bundled PV Tool kinetic typography web app for lyric videos, promotional videos, and motion-graphics text overlays.
  • Use this whenever the user mentions PV Tool, wants to run or preview the app locally, build it for distribution, experiment with PV templates and effects, or work with lyric text, media backgrounds, audio-reactive overlays, or LRC input inside PV Tool.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

vercel-react-best-practices Shared topics
vercel-labs/agent-skills 697.8K installs
azure-hosted-copilot-sdk Shared topics
microsoft/azure-skills 440.4K installs
vercel-composition-patterns Shared topics
vercel-labs/agent-skills 326.5K installs
vercel-react-native-skills Shared topics
vercel-labs/agent-skills 205.5K installs
chrome-devtools Similar name
github/awesome-copilot

Expert-level browser automation, debugging, and performance analysis using Chrome DevTools MCP.…

14.9K installs
devtools Similar name
vercel-labs/json-render

Drop-in inspector panel for any json-render app.

4.6K installs

Also in this package

Other skills from stvlynn/skills · top by installs.

npx skills add stvlynn/skills
xiaohongshu 84 claude-code-operator 35 create-sticker 32 searxng 17 qwen-asr 14 tsticker 14 qwen-tts 11 atlassian-design 6 tip-gui-skill 4 scroll-fade-mask 2

Browse all from stvlynn/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 57
License app/LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,879 B
  • docs SUMMARY.md 395 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 3 installs

SKILL.md

PV Tool Skill

Use this skill to operate the vendored pv-tool application in app/.

What this skill is for

  • Start the local PV Tool dev server
  • Build the bundled app
  • Preview the production build
  • Use the app for lyric-video and kinetic-typography workflows

Important license note

The bundled upstream app in app/ is not under a generic permissive license.

  • Non-commercial use only by default
  • Commercial use requires a separate license from the upstream author
  • Check app/LICENSE and app/COMMERCIAL.md before using it for paid work

If the user asks to use PV Tool for a commercial workflow, call out this restriction explicitly.

Runtime requirements

  • Node.js 20+
  • npm

Commands

Run commands from skills/pv-tool/:

bash scripts/bootstrap.sh
bash scripts/dev.sh
bash scripts/build.sh
bash scripts/preview.sh

Environment overrides:

PV_TOOL_DEV_HOST=0.0.0.0
PV_TOOL_DEV_PORT=4173
PV_TOOL_PREVIEW_HOST=127.0.0.1
PV_TOOL_PREVIEW_PORT=4174
VITE_BASE=/pv-tool/

Standard workflow

  1. Run bash scripts/bootstrap.sh to install dependencies into app/node_modules.
  2. Run bash scripts/dev.sh for local editing and experimentation.
  3. Open the reported local URL and use the UI.
  4. Run bash scripts/build.sh when the user wants a production build.
  5. Run bash scripts/preview.sh to verify the built output in a browser.

In-app usage

  • Start from a preset template or switch to Custom
  • Enter text with / as the segment separator
  • Load an image or video as the background media layer
  • Load audio for BPM and beat-reactive effects
  • Import .lrc files for lyric timing
  • Adjust post-FX such as shake, zoom, tilt, glitch, and hue shift
  • Use the built-in recording/export controls when the user needs captured output

Agent behavior

  • Prefer running the provided scripts instead of manually restating npm commands.
  • When starting dev.sh or preview.sh, report the exact local URL.
  • Keep long-running server processes attached unless the user asks to daemonize them.
  • If dependencies are missing, let the wrapper scripts install them first.
  • If Node.js is too old, stop and tell the user to upgrade before proceeding.

File layout

  • app/ — vendored upstream PV Tool source
  • scripts/bootstrap.sh — dependency installation
  • scripts/dev.sh — local Vite dev server
  • scripts/build.sh — production build
  • scripts/preview.sh — local preview server