Agent skill

Enable Worklets Bundle Mode

by software-mansion-labs in software-mansion-labs/skills

Enable react-native-worklets Bundle Mode (imports inside worklets, third party libraries on worklet runtimes) in an Expo, RN CLI or brownfield React Native app, including the mandatory…

No licenceAuto-check passedMobile

Install Enable Worklets Bundle Mode

skills CLI
$ npx skills add software-mansion-labs/skills --skill enable-worklets-bundle-mode -a claude-code

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

GitHub CLI
$ gh skill install software-mansion-labs/skills enable-worklets-bundle-mode --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/software-mansion-labs/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/react-native-best-practices/references/enable-worklets-bundle-mode .claude/skills/enable-worklets-bundle-mode && 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
enable-worklets-bundle-mode
GitHub stars
291
Token cost
~4k tokens
SKILL.md length
1,565 words
Files
6 (incl. references)
Skills in repo
20
Repo updated
First seen
Licence
None found

At a glance

Enable react-native-worklets Bundle Mode (imports inside worklets, third party libraries on worklet runtimes) in an Expo, RN CLI or brownfield React Native app, including the mandatory…

  • Works in 5 steps: Detect current state and environment → Babel plugin → Metro config → …
  • The user asks to enable Bundle Mode
  • SKILL.md covers 0. Detect current state and…, 1. Babel plugin, 2. Metro config and 3. Metro patches (do not skip), plus 3 more sections
  • Calls npx, pnpm and yarn; reaches raw.githubusercontent.com and api.github.com

What it does

Enable Worklets Bundle Mode is an agent skill from software-mansion-labs/skills. Enable react-native-worklets Bundle Mode (imports inside worklets, third party libraries on worklet runtimes) in an Expo, RN CLI or brownfield React Native app, including the mandatory metro/metro-runtime patches. Use when the user asks to enable Bundle Mode, wants to import npm libraries inside worklets or offload JS code to worklet runtimes, or hits "Failed to get the SHA-1" errors in a worklets Bundle Mode project / missing Fast Refresh for worklet code. Covers enabling only — not disabling; upgrades…

Its SKILL.md is about 4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/patching-bun.md`, `references/patching-patch-package.md` and `references/patching-pnpm.md`). Compatibility notes: Requires network access to raw.githubusercontent.com and api.github.com to fetch metro patches

It sits in Mobile, covering Cross-platform mobile apps. It works with React Native, npm and Expo. The repository describes itself as: Software Mansion's set of skills for AI-assisted React Native development.

When your agent uses it

  • The user asks to enable Bundle Mode
  • Wants to import npm libraries inside worklets
  • Offload JS code to worklet runtimes
  • Hits Failed to get the SHA-1 errors in a worklets Bundle Mode project / missing Fast Refresh for worklet code

Example prompts

  • “Failed to get the SHA-1”
  • “/enable-worklets-bundle-mode”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Requires network access to raw.githubusercontent.com and api.github.com to fetch metro patches

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Detect current state and environment
  2. Babel plugin
  3. Metro config
  4. Metro patches (do not skip)
  5. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit e3f00cd. 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:

    • npx
    • pnpm
    • yarn
    • node
    • npm

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com
    • api.github.com

    Also links to:

    • docs.swmansion.com
    • github.com
    • docs.expo.dev

    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.

  • Compatibility

    Requires network access to raw.githubusercontent.com and api.github.com to fetch metro patches

    From compatibility in the SKILL.md frontmatter.

Context cost

Enable Worklets Bundle Mode loads about 4k tokens when it runs, and up to ~6.9k if it reads all its reference files. Until then it costs about 165 tokens; SKILL.md has 1,565 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,565 words (~3,960 tokens).

“Bundle Mode lets worklets access the entire JS bundle (imports inside worklets, etc.). Stable since react-native-worklets 0.10.0. Official setup docs: https://docs.swmansion.com/react-native-worklets/docs/bundleMode/setup”

— opening of SKILL.md by software-mansion-labs
name
enable-worklets-bundle-mode
compatibility
Requires network access to raw.githubusercontent.com and api.github.com to fetch metro patches
metadata.author
Tomasz Żelawski
metadata.version
1.0.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (references) in skills/react-native-best-practices/references/enable-worklets-bundle-mode of software-mansion-labs/skills.

  • SKILL.md
  • references/patching-bun.md
  • references/patching-patch-package.md
  • references/patching-pnpm.md
  • references/patching-yarn-berry.md
  • references/uniwind-remap-workaround.md

Open the folder on GitHubat commit e3f00cd

Compare with similar skills

Enable Worklets Bundle Mode 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.

Enable Worklets Bundle Mode compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Enable Worklets Bundle Mode this skillsoftware-mansion-labs/skills291—~4kAutomated safety check: PassNone
Upgrading React Nativecallstackincubator/agent-skills1.7k1 repos~1.1kAutomated safety check: PassMIT
React Native Best Practiceskingstinct/react-native-healthkit7161 repos~861Automated safety check: PassMIT
React Native Developmentjohnku2011/boilerplates-with-ai-skills240—~596Automated safety check: PassMIT
Expo Overviewexpo/skills2.7k1 repos~2.3kAutomated safety check: PassMIT
React Native Best Practicesvercel-labs/openreview1.7k17 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Upgrading React Native

    callstackincubator/agent-skills

    Official

    Upgrades React Native apps to newer versions by applying rn-diff-purge template diffs, updating package.json dependencies, migrating native iOS and Android configuration, resolving CocoaPods and…

    1.7k GitHub starsUsed in 1 repo~1.1k tokens
    MobileAuto-check passed
  • React Native Best Practices

    kingstinct/react-native-healthkit

    Software Mansion's best practices for production React Native and Expo apps on the New Architecture.

    716 GitHub starsUsed in 1 repo~861 tokens
    MobileAuto-check passed
  • React Native Development

    johnku2011/boilerplates-with-ai-skills

    A skill your agent uses when building screens, navigation, styling, or platform behavior in this Expo React Native app, to follow mobile-first conventions and keep logic testable.

    240 GitHub stars~596 tokensUpdated 1 mo ago
    MobileAuto-check passed
  • Expo Overview

    expo/skills

    Official

    Entry point and router for every Expo or EAS task. An agent skill from expo/skills.

    2.7k GitHub starsUsed in 1 repo~2.3k tokens
    MobileAuto-check passed
  • React Native Best Practices

    vercel-labs/openreview

    Official

    A prioritized rule set for React Native and Expo apps covering list performance, animation, navigation, UI patterns, state, rendering, monorepos and configuration.

    1.7k GitHub starsUsed in 17 repos~1.1k tokens
    MobileAuto-check passed
  • Appllama App Design Skill

    Appllama/appllama-skills

    Build native-feeling, benchmark-quality mobile app screens (Expo / React Native).

    2.5k GitHub starsUsed in 1 repo~5k tokens
    MobileAuto-check passed

More from software-mansion-labs/skills

All 20 skills in this repo
  • Detour Onboarding

    software-mansion-labs/skills

    Complete onboarding guide for developers who are new to Detour, the open-source deferred deep linking SDK by Software Mansion.

    291 GitHub stars~2.8k tokensUpdated 10 days ago
    Auto-check passed
  • Typegpu

    software-mansion-labs/skills

    TypeGPU is type-safe WebGPU in TypeScript. An agent skill from software-mansion-labs/skills.

    291 GitHub starsUsed in 2 repos~5.6k tokens
    Auto-check passed
  • Moq Kit

    software-mansion-labs/skills

    Software Mansion's moq-kit — native Swift (iOS) and Kotlin (Android) SDKs for Media over QUIC (moq-lite) live streaming: sub-second-latency playback, camera/microphone/screen publishing, and…

    291 GitHub stars~5k tokensUpdated 10 days ago
    Auto-check passed
  • React Native Moq

    software-mansion-labs/skills

    Software Mansion's react-native-moq — Media over QUIC (MoQ) live streaming for React Native: sub-second-latency video/audio playback, camera/mic/screen publishing, and realtime data tracks over a…

    291 GitHub stars~1.6k tokensUpdated 10 days ago
    Auto-check passed
  • Expo Horizon

    software-mansion-labs/skills

    Software Mansion's guide for migrating Expo SDK apps to Meta Quest using expo-horizon packages.

    291 GitHub stars~2.8k tokensUpdated 10 days ago
    Auto-check passed
  • Fishjam JS Server SDK

    software-mansion-labs/skills

    Node.js / TypeScript server SDK for Fishjam — backends that create rooms, mint peer tokens, listen to server notifications, and run agents.

    291 GitHub stars~1.4k tokensUpdated 10 days ago
    Auto-check passed

Categories

Questions about Enable Worklets Bundle Mode

What does Enable Worklets Bundle Mode do?

Enable react-native-worklets Bundle Mode (imports inside worklets, third party libraries on worklet runtimes) in an Expo, RN CLI or brownfield React Native app, including the mandatory…. Enable Worklets Bundle Mode is an agent skill from software-mansion-labs/skills. Enable react-native-worklets Bundle Mode (imports inside worklets, third party libraries on worklet runtimes) in an Expo, RN CLI or brownfield React Native app, including the mandatory metro/metro-runtime patches.

When should I use Enable Worklets Bundle Mode?

Enable Worklets Bundle Mode fits situations like: the user asks to enable Bundle Mode; wants to import npm libraries inside worklets; offload JS code to worklet runtimes; hits Failed to get the SHA-1 errors in a worklets Bundle Mode project / missing Fast Refresh for worklet code.

How do I install Enable Worklets Bundle Mode in Claude Code?

Run `npx skills add software-mansion-labs/skills --skill enable-worklets-bundle-mode -a claude-code`. Or copy the skill folder (skills/react-native-best-practices/references/enable-worklets-bundle-mode in software-mansion-labs/skills) into .claude/skills/enable-worklets-bundle-mode in your project. Claude Code loads it when a task matches its description.

How do I install Enable Worklets Bundle Mode in Codex?

Run `npx skills add software-mansion-labs/skills --skill enable-worklets-bundle-mode -a codex`. Or copy the skill folder (skills/react-native-best-practices/references/enable-worklets-bundle-mode in software-mansion-labs/skills) into .agents/skills/enable-worklets-bundle-mode in your project. Codex loads it when a task matches its description.

Can I use Enable Worklets Bundle Mode 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 software-mansion-labs/skills --skill enable-worklets-bundle-mode -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/enable-worklets-bundle-mode, .gemini/skills/enable-worklets-bundle-mode, .github/skills/enable-worklets-bundle-mode and .opencode/skills/enable-worklets-bundle-mode in your project.

What does Enable Worklets Bundle Mode need to run?

Going by SKILL.md and its folder, Enable Worklets Bundle Mode needs the command-line tools its instructions call (npx, pnpm, yarn, node and npm). Our summary lists: Node.js. Compatibility (from SKILL.md): Requires network access to raw.githubusercontent.com and api.github.com to fetch metro patches.

Does Enable Worklets Bundle Mode access the network?

SKILL.md names 5 domains. In commands or code: raw.githubusercontent.com and api.github.com; the agent is likely to contact these when it follows the instructions. As links in the text: docs.swmansion.com, github.com and docs.expo.dev. This is read from the text; nothing was executed.

Is Enable Worklets Bundle Mode 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 Enable Worklets Bundle Mode use?

No licence was found for Enable Worklets Bundle Mode or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Enable Worklets Bundle Mode use?

About 4k tokens (SKILL.md is roughly 16k 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 3k tokens, read only when the agent opens those files.

What are the alternatives to Enable Worklets Bundle Mode?

Skills that share tags, products or a category with Enable Worklets Bundle Mode: Upgrading React Native (callstackincubator/agent-skills, 1.7k stars), React Native Best Practices (kingstinct/react-native-healthkit, 716 stars), React Native Development (johnku2011/boilerplates-with-ai-skills, 240 stars) and Expo Overview (expo/skills, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Enable Worklets Bundle Mode?

software-mansion-labs (a GitHub organization) maintains it in software-mansion-labs/skills, which has 291 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on September 28, 2026.

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