Agent skill · software engineering · jakubantalik
refine-live
In-chat fallback for the Timeline Inspector Refine agent. Use when the user runs `/refine live`, asks to "refine live", "go live", or answer refine jobs — but ONLY when no persistent agent is wired (no `npx transitions-refine live`). Prefer `npx transitions-refine live` for run-and-forget (relay spawns agent per click, no idle credit burn). This skill long-polls the relay, posts suggestions, handles scan/apply jobs.
Why this skill is useful
Adds specific long-polling commands and job handling patterns for the Refine agent that the AI wouldn't reliably generate on its own.
What it needs
About 11k tokens when loaded. Last updated 2026-07-30. 2,548 stars on the source repository.
What this skill does
Refine Live Two modes Persistent (recommended — run and forget) Run npx transitions-refine live from your project. The CLI starts the relay and wires REFINEAGENTCMD so the relay spawns your agent CLI per Refine click. No chat loop; idle = zero credit burn. Works hours later as long as the relay process keeps running. Stop with Ctrl-C (or npx transitions-refine stop). In-chat loop (fallback — this skill) Run /refine live in Cursor/Claude/Codex when the relay is up but has no REFINEAGENTCMD. You become the poller via GET /jobs/next. The Agent tab stays available only while you keep polling — each idle poll cycle consumes chat turns/credits. Say "stop refine" to exit. Use the in-chat loop only when you cannot wire a persistent agent CLI. --- Turn yourself into the LLM behind the Timeline Inspector's Refine button (in-chat fallback mode). While this loop runs, the panel's LLM tab is "available": each click sends one transition here, you reason about it, and your suggestions appear in the panel. You are the poller. Nothing is installed — you just talk to a small local relay (default http://localhost:7331) that the npx injector already started. How it works The loop — stay live, but don't burn credits forever Keep polling so the panel's LLM tab stays "available", but this loop costs chat turns/credits even while idle, so it is not truly run-and-forget — it has three exits, in priority order: 1. Relay stop signal (authoritative). GET /jobs/next may return 200 with {"stop": true}. The relay sends this when the user clicks Stop in the panel, or automatically after ~10 min with no jobs. Always honor it: stop looping immediately, tell the user the LLM tab will go unavailable and how to resume (/refine live), and end your turn. Never re-poll after a stop signal. 2. The user says so — "stop refine", "exit live", etc. 3. Your own idle backoff (safety net). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jakubantalik/refine-live