Agent skill

Trigger.dev Realtime

by papermark in papermark/papermark

Shows how to subscribe to Trigger.dev task runs from the backend and from React for progress indicators, live dashboards, AI response streams and approval waits.

Custom licenceAuto-check passedBackend & APIs

Install Trigger.dev Realtime

skills CLI
$ npx skills add papermark/papermark --skill trigger-realtime -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install papermark/papermark trigger-realtime --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/papermark/papermark.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/trigger-realtime .claude/skills/trigger-realtime && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
trigger-realtime
GitHub stars
9.2k
Token cost
~1.7k tokens
SKILL.md length
187 words
Files
2 (incl. references)
Skills in repo
6
Repo updated
First seen
Licence
Custom licence

At a glance

Shows how to subscribe to Trigger.dev task runs from the backend and from React for progress indicators, live dashboards, AI response streams and approval waits.

  • Works in 5 steps: Scope tokens narrowly — only grant… → Set expiration times — don't use… → Use typed hooks — pass task types for… → …
  • Showing live progress for a long-running background task
  • SKILL.md covers When to Use, Authentication, Backend Subscriptions and React Hooks, plus 4 more sections
  • Calls npm

What it does

Backend code creates short-lived public access tokens (read-only for specific runs) or trigger tokens for starting tasks from the frontend, and server code can trigger a task and subscribe to its run updates. In React, the @trigger.dev/react-hooks package supplies hooks to trigger a task, follow one run, or follow every run that shares a tag.

Realtime Streams cover AI or LLM output: a stream is defined in a shared file, piped from inside a task, and read in a component with a stream hook. Wait tokens support human-in-the-loop approval, where a task pauses until the frontend completes a token. A table lists run properties such as id, status (queued, executing, completed, failed or canceled), payload and output.

When your agent uses it

  • Showing live progress for a long-running background task
  • Building a dashboard of task runs grouped by tag
  • Streaming an LLM response from a task into the UI
  • Pausing a task until a user approves it in the frontend

Example prompts

  • “Add a progress bar to the export page that follows the export task run in real time.”
  • “Stream the summarization task's output into the chat component.”
  • “Create a read-only public access token for one run so the browser can watch it.”

Requirements

  • A Trigger.dev project using @trigger.dev/sdk
  • The @trigger.dev/react-hooks package for React components

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Scope tokens narrowly — only grant necessary permissions
  2. Set expiration times — don't use long-lived tokens
  3. Use typed hooks — pass task types for proper inference
  4. Handle errors — always check for errors in hooks
  5. Throttle streams — use throttleInMs to control re-renders

What it can do on your machine

Read from SKILL.md and the folder at commit ed19717. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Trigger.dev Realtime loads about 1.7k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 187 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 187 words (~1,699 tokens).

“Subscribe to task runs and stream data in real-time from frontend and backend.”

— opening of SKILL.md by papermark, Custom licence
name
trigger-realtime

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in .agents/skills/trigger-realtime of papermark/papermark.

  • SKILL.md
  • references/realtime.md

Open the folder on GitHubat commit ed19717

Compare with similar skills

Trigger.dev Realtime next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Trigger.dev Realtime compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trigger.dev Realtime this skillpapermark/papermark9.2k—~1.7kAutomated safety check: PassCustom licence
React Emailviclafouch/meme-studio1102 repos~3.6kAutomated safety check: PassMIT
South Admin CRUD Generatorsouthliu/south-admin-react580—~1.7kAutomated safety check: PassMIT
React Render Types CompositionHorusGoul/eslint-plugin-react-render-types111—~1.1kAutomated safety check: PassMIT
Safe Element Comparisonseasonedcc/remix-forms514—~1.8kAutomated safety check: PassMIT
Fork And GoSimplePDF/simplepdf-embed407—~7.9kAutomated safety check: NotesMIT

Similar skills

  • React Email

    viclafouch/meme-studio

    A skill your agent uses when creating HTML email templates with React components - welcome emails, password resets, notifications, order confirmations, newsletters, or transactional emails.

    110 GitHub starsUsed in 2 repos~3.6k tokens
    Backend & APIsAuto-check passed
  • South Admin CRUD Generator

    southliu/south-admin-react

    Generates a full CRUD page - page component, data model and API client - from the south-admin-react project's own VS Code snippet templates.

    580 GitHub stars~1.7k tokensUpdated 17 days ago
    Frontend & DesignAuto-check passed
  • React Render Types Composition

    HorusGoul/eslint-plugin-react-render-types

    Composition patterns for building React components with @renders type annotations from eslint-plugin-react-render-types.

    111 GitHub stars~1.1k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Safe Element Comparison

    seasonedcc/remix-forms

    Maintain element type comparison safety in remix-forms. An agent skill from seasonedcc/remix-forms.

    514 GitHub stars~1.8k tokensUpdated 5 mo ago
    Frontend & DesignAuto-check passed
  • Fork And Go

    SimplePDF/simplepdf-embed

    Guided walkthrough for forking and deploying your own SimplePDF Copilot: hosting choice, Pro-account confirmation, AI-provider wiring, demo customization, deploy, and the SimplePDF whitelist step.

    407 GitHub stars~7.9k tokensUpdated 7 days ago
    Frontend & DesignAuto-check: notes
  • Agents SDK

    hodgef/apiker

    Build AI agents on Cloudflare Workers using the Agents SDK. An agent skill from hodgef/apiker.

    127 GitHub starsUsed in 3 repos~3k tokens
    Backend & APIsAuto-check passed

More from papermark/papermark

  • Trigger.dev Agent Patterns

    papermark/papermark

    Patterns for building LLM agents on Trigger.dev tasks: prompt chaining, routing, parallel workers, orchestrator-workers, evaluator loops and human approval gates.

    9.2k GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Trigger.dev Configuration

    papermark/papermark

    Configures Trigger.dev projects through trigger.config.ts, with build extensions for Prisma, Playwright, Puppeteer, FFmpeg, Python and system packages.

    9.2k GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Audits Trigger.dev tasks, schedules and run history for wasteful machine sizes, retries, polling and cron frequency to cut spend.

    9.2k GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Trigger.dev Background Tasks

    papermark/papermark

    Guides building durable background tasks, scheduled jobs and queues with Trigger.dev, including retries, waits, idempotency and concurrency limits.

    9.2k GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • GitHub CLI Reference

    papermark/papermark

    Reference for the gh command line tool covering repositories, issues, pull requests, Actions, releases, gists and codespaces, with install and login steps.

    9.2k GitHub starsUsed in 4 repos~9.8k tokens
    Auto-check: warnings

Works with

Questions about Trigger.dev Realtime

What does Trigger.dev Realtime do?

Shows how to subscribe to Trigger.dev task runs from the backend and from React for progress indicators, live dashboards, AI response streams and approval waits. Backend code creates short-lived public access tokens (read-only for specific runs) or trigger tokens for starting tasks from the frontend, and server code can trigger a task and subscribe to its run updates.dev/react-hooks package supplies hooks to trigger a task, follow one run, or follow every run that shares a tag.

When should I use Trigger.dev Realtime?

Trigger.dev Realtime fits situations like: showing live progress for a long-running background task; building a dashboard of task runs grouped by tag; streaming an LLM response from a task into the UI; pausing a task until a user approves it in the frontend.

How do I install Trigger.dev Realtime in Claude Code?

Run `npx skills add papermark/papermark --skill trigger-realtime -a claude-code`. Or copy the skill folder (.agents/skills/trigger-realtime in papermark/papermark) into .claude/skills/trigger-realtime in your project. Claude Code loads it when a task matches its description.

How do I install Trigger.dev Realtime in Codex?

Run `npx skills add papermark/papermark --skill trigger-realtime -a codex`. Or copy the skill folder (.agents/skills/trigger-realtime in papermark/papermark) into .agents/skills/trigger-realtime in your project. Codex loads it when a task matches its description.

Can I use Trigger.dev Realtime in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add papermark/papermark --skill trigger-realtime -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trigger-realtime, .gemini/skills/trigger-realtime, .github/skills/trigger-realtime and .opencode/skills/trigger-realtime in your project.

What does Trigger.dev Realtime need to run?

Going by SKILL.md and its folder, Trigger.dev Realtime needs the command-line tools its instructions call (npm). Our summary lists: A Trigger.dev project using @trigger.dev/sdk; The @trigger.dev/react-hooks package for React components.

Does Trigger.dev Realtime access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Trigger.dev Realtime safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Trigger.dev Realtime use?

Trigger.dev Realtime has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Trigger.dev Realtime use?

About 1.7k tokens (SKILL.md is roughly 6.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Trigger.dev Realtime?

Skills that share tags, products or a category with Trigger.dev Realtime: React Email (viclafouch/meme-studio, 110 stars), South Admin CRUD Generator (southliu/south-admin-react, 580 stars), React Render Types Composition (HorusGoul/eslint-plugin-react-render-types, 111 stars) and Safe Element Comparison (seasonedcc/remix-forms, 514 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trigger.dev Realtime?

papermark (a GitHub organization) maintains it in papermark/papermark, which has 9,242 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on August 28, 2026.

Source: papermark/papermark on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.