
react-native-ai-skills
β 1,360by callstackincubator Β· part of callstackincubator/ai
Provides integration recipes for the React Native AI @react-native-ai packages that wrap the Llama.rn (Llama.cpp), MLC-LLM, Apple Foundation backends. Use when integrating local on-device AI in React Native, setting up providers, model management.
This is the playbook your agent receives when the skill activates β you don't need to read it to use the skill, but it's here to audit before installing.
React Native AI Skills
Overview
Example workflow for integrating on-device AI in React Native apps using the @react-native-ai ecosystem. Available provider tracks (can be combined):
- Apple β Apple Intelligence (iOS 26+)
- Llama β GGUF models via llama.rn
- MLC β MLC-LLM models
- NCNN β Low-level NCNN inference wrapper (vision, custom models)
Path Selection Gate (Must Run First)
Before selecting any reference file, classify the user request:
- Select Apple:
- if you intend to build with:
apple,Apple Intelligence,Apple Foundation Models - if you want features:
transcription,speech synthesis,embeddingson Apple devices - optionally with capabilities: tool calling
- if you intend to build with:
- Select Llama:
- if you intend to use the following technologies:
llama,GGUF,llama.rn,HuggingFace,SmolLM - if you want to perform the following operations:
embedding model,rerank,speech model
- if you intend to use the following technologies:
- Select MLC:
- if you intend to use a library that allows for custom models and involves build-time model optimizations
- Select NCNN:
- if you need to use run low-level inference on bare metal tensors
- if you intend to run inference of custom models such as convolutional networks, multi-layer perceptrons, low-level inference, etc.
- DO NOT select NCNN if the prompt mentions LLMs only, this use case is better solved by other providers
Skill Format
Each reference file follows a strict execution format:
- Quick Command
- When to Use
- Prerequisites
- Step-by-Step Instructions
- Common Pitfalls
- Related Skills
Use the checklists exactly as written before moving to the next phase.
When to Apply
Reference this package when:
- Integrating on-device AI in React Native apps
- Installing and configuring @react-native-ai providers
- Managing model downloads (llama, mlc)
- Wiring providers with Vercel AI SDK (generateText, streamText)
- Implementing SetupAdapter pattern for multi-provider apps
- Debugging native module or Expo plugin issues
Priority-Ordered Guidelines
| Priority | Category | Impact | Start File |
|---|---|---|---|
| 1 | Path selection and baseline | N/A | quick-start |
| 2 | Apple provider | N/A | apple-provider |
| 3 | Llama provider | N/A | llama-provider |
| 4 | MLC-LLM provider | N/A | mlc-provider |
| 5 | NCNN provider | N/A | ncnn-provider |
Quick Reference
npm install
# Provider-specific install
npm add @react-native-ai/apple
npm add @react-native-ai/llama llama.rn
npm add @react-native-ai/mlc
npm add @react-native-ai/ncnn-wrapperRoute by path:
- Apple: apple-provider
- Llama: llama-provider
- MLC: mlc-provider
- NCNN: ncnn-provider
References
| File | Impact | Description |
|---|---|---|
| quick-start | N/A | Shared preflight |
| apple-provider | N/A | Apple Intelligence setup and integration |
| llama-provider | N/A | GGUF models, llama.rn, model management |
| mlc-provider | N/A | MLC models, download, prepare, Expo plugin |
| ncnn-provider | N/A | NCNN wrapper, loadModel, runInference |
Problem β Skill Mapping
| Problem | Start With |
|---|---|
| Need path decision first | quick-start |
| Integrate Apple Intelligence | apple-provider |
| Run GGUF models from HuggingFace | llama-provider |
| Run MLC-LLM models (Llama, Phi, Qwen) | mlc-provider |
| Use NCNN for custom inference | ncnn-provider |
| Multi-provider app with SetupAdapter | quick-start β provider-specific |
| Expo + native module setup | Provider-specific (each has Expo notes) |
npx skills add https://github.com/callstackincubator/ai --skill react-native-ai-skillsRun this in your project β your agent picks the skill up automatically.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITβ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub β