refine-live

Polls a local relay to answer CSS transition refinement jobs from the Timeline Inspector panel.

3|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/langgenius/due-date-hq-jwl --skill refine-live-langgenius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-live
Source: https://github.com/langgenius/due-date-hq-jwl/tree/main/.claude/skills/refine-live
Command: npx skills add https://github.com/langgenius/due-date-hq-jwl --skill refine-live-langgenius

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When the Timeline Inspector's Refine button has no persistent agent wired, the panel's LLM tab stays unavailable and transition refinement jobs go unanswered. This Skill turns the chat session into a fallback polling agent that claims, reasons about, and answers those jobs against a local relay. ## Core Features & Use Cases - In-chat job polling: Long-polls GET /jobs/next on the local relay (default port 7331), honoring stop signals, user exit commands, and idle backoff to limit credit burn. - Three job types: Answers suggestion jobs (motion-token tweaks for small, whole-recipe swaps for replace), scan jobs that group DOM-detected transitions into component open/close phases, and apply jobs that write accepted timings back into source files. - Use Case: A developer clicks Refine on a dropdown in the Timeline Inspector; this loop claims the job, matches the usage to motion tokens or a transitions.dev recipe, and posts suggestion cards that appear in the panel within seconds. ## Quick Start Run /refine live to start polling the local relay and answer Refine jobs from the Timeline Inspector panel.

Frequently Asked Questions about refine-live

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run the Refine agent without installing a persistent CLI?

Run /refine live in your chat session while the relay is up. The skill long-polls GET /jobs/next on localhost:7331, claims Refine jobs, and posts suggestions back so the panel's LLM tab stays available.

What is the difference between refine live and npx transitions-refine live?

npx transitions-refine live wires a persistent agent the relay spawns per Refine click, costing nothing while idle. The /refine live in-chat loop makes the chat session the poller, which consumes chat turns even when idle, so it is the fallback option.

How do I stop the refine live polling loop?

Say "stop refine" or click Stop in the panel. The relay returns {"stop": true} from GET /jobs/next, and the loop also auto-stops after roughly 10 minutes of idle polling to avoid burning credits.

What job types does the Refine relay send to the agent?

Three kinds: suggestion jobs (small motion-token tweaks or whole-recipe replace swaps), scan jobs that group DOM-detected transitions into component open/close phases, and apply jobs that write accepted timings into source files.

Why does the LLM tab show unavailable in the Timeline Inspector?

The relay marks the agent available for only about 120 seconds after the last poll. If the loop stopped via a stop signal, user command, or idle auto-stop, restart it with /refine live to make the tab available again.