callstackincubator/agent-skills
10 skills55.5k installs15.7k starsGitHub
Install
npx skills add https://github.com/callstackincubator/agent-skillsSkills in this repo
1React Native Best Practicesreact-native-best-practices is a Callstack performance skill drawn from the Ultimate Guide to React Native Optimization. It covers JavaScript and React tuning, native iOS and Android optimizations, and bundling improvements for FPS, TTI, bundle size, memory leaks, re-renders, and animations. Topics include Hermes optimization, JS thread blocking, bridge overhead, FlashList usage, native modules, and debugging frame drops. Developers reach for react-native-best-practices when production mobile apps show jank, bloated bundles, or memory growth under real device load.21kinstalls2Upgrading React NativeUpgrades 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 Gradle changes, and handling breaking API updates. Use when upgrading React Native, bumping RN version, updating from RN 0.x to 0.y, or migrating Expo SDK alongside a React Native upgrade. --- name: upgrading-react-native description: 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 Gradle changes, and handling breaking API updates. Use when upgrading React Native, bumping RN version, updating from RN 0.x to 0.y, or migrating Expo SDK alongside a React Native upgrade. license: MIT metadata: author: Callstack tags: react-native, upgrade, upgrade-helper, npm, changelog, cocoapods, ios, android --- # Upgrading React Native ## Overview Covers the full React Native upgrade workflow: template diffs via Upgrade Helper, dependency updates, Expo SDK steps, and common pitfalls.7.3kinstalls3Agent DeviceAutomates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, or extracting UI info across mobile, TV, and desktop targets. --- name: agent-device description: Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, or extracting UI info across mobile, TV, and desktop targets. --- # agent-device Use this skill as a router with mandatory defaults. For normal device tasks, always load `references/bootstrap-install.md` and `references/exploration.md` before acting. Use bootstrap to confirm or establish deterministic setup. Use exploration for UI inspection, interaction, and verification once the app session is open. ## Default operating rules - Start conservative. Prefer read-only inspection before mutating the UI. - Use plain `snapshot` when the task is to verify what text or structure is currently visible on screen.6.6kinstalls4GithubThis skill provides patterns and commands for managing GitHub pull requests via the gh CLI, covering PR creation, squash merging, and the full stacked PR workflow. Developers use it when working with chains of dependent branches that must be merged into main as individual squash commits. The stacked PR workflow involves merging the first PR, then rebasing each subsequent branch onto main, updating its base, and squash merging. Conflicts during rebase stop the automation and prompt the user to resolve manually. The skill explicitly favors gh CLI over GitHub MCP servers to reduce context usage.6.5kinstalls5Github ActionsThe Callstack github-actions skill documents reusable GitHub Actions patterns that build React Native apps for iOS simulators and Android emulators in the cloud, then publish installable artifacts retrievable with the gh CLI or GitHub REST API. Use it when creating CI workflows for simulator or emulator builds, uploading iOS simulator and Android emulator installables from pull requests or manual dispatch runs, replacing local-only mobile builds with downloadable CI artifacts, or scripting stable artifact IDs and names for automation. The quick reference adds composite actions from gha-ios-composite-action.md and gha-android-composite-action.md, wires them into .github/workflows/mobile-build.yml per gha-workflow-and-downloads.md, uploads with actions/upload-artifact@v4 while capturing the artifact-id output, and downloads via gh run download or GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/{archive_format}. A problem-to-file table routes iOS .app.tar.gz, Android .apk, combined workflows, and scripted downloads to the matching reference doc, with source inspiration from callstackincubator ios and android action.yml files.5.8kinstalls6Validate SkillsValidate Skills is a Callstack agent skill that audits every directory under skills/ against the agentskills.io specification and Claude Code authoring best practices. Run it via the /validate-skills command before publishing or merging skill contributions. For each skill it checks name format and directory parity, description length, optional metadata validity, third-person description style, body length under five hundred lines, one-level-deep references, markdown links instead of bare filenames, and redundancy between frontmatter and body. The workflow finds top-level skill folders with fd, reads each SKILL.md, marks PASS or FAIL per rule, and reports in a structured Validation Results block citing concrete violations such as directory name mismatches. Designed for maintainers of agent skill repositories who need consistent spec compliance without manual checklist drudgery. References agentskills.io and Claude Code skill docs as authoritative sources.5.2kinstalls7React Native Brownfield Migrationreact-native-brownfield-migration is a Callstack agent skill for incremental adoption of React Native inside existing native iOS or Android applications using @callstack/react-native-brownfield. It prescribes a migration strategy: assess the app, choose Expo or bare React Native once, perform initial brownfield setup, package XCFramework or AAR artifacts from the RN source app, integrate one surface into the host, validate startup, then repeat per feature. A mandatory path-selection gate routes greenfield Expo creation, Expo plugin workflows, or bare native CLI projects before any platform steps run. Reference files cover Expo and bare quick starts, iOS XCFramework generation, Android AAR publish, and host integration for each track with placeholders such as framework target and module names resolved from project files. Global guardrails forbid mixing Expo and bare steps, require validating packaging commands before host wiring, and prefer facade APIs over direct React Native calls in host apps. Developers reach for this skill when planning brownfield RN rollout, generating distributable RN binaries, or integrating RN screens into legacy native codebases.3.2kinstalls8React Native TestingThis skill is a guide for writing React Native component tests with React Native Testing Library (RNTL) v13 and v14. It covers render, the screen API, query variants, Jest matchers, userEvent versus fireEvent, and async patterns like findBy and waitFor. It detects the installed RNTL version and loads the matching v13 or v14 reference. A developer uses it when writing, reviewing, or fixing RN component tests.14installs9DogfoodThis skill drives the agent-device CLI to systematically explore a mobile app on iOS or Android and produce a structured report. It initializes a session, launches and optionally authenticates, orients on navigation, explores flows and edge states, and documents each issue with screenshots and optional repro videos. A developer uses it to run repeatable exploratory QA and get reproduction steps for every finding.8installs10Vercel React Native SkillsThis skill provides prioritized best-practice rules for React Native and Expo apps. It spans list and scroll performance, animations with Reanimated, navigation, UI patterns, state management, rendering, and monorepo configuration. Each rule file explains why the rule matters and shows incorrect and correct code examples. A developer references it when building RN or Expo components or optimizing mobile performance.7installs