feat: rn-skills CLI

.github/workflows/update-vendored-skills.yml

@@ -3,7 +3,7 @@ name: Update vendored skills
 on:
   workflow_dispatch:
   schedule:
-    - cron: "17 2 * * *"
+    - cron: '17 2 * * *'
 
 permissions:
   contents: write
@@ -28,15 +28,18 @@ jobs:
 
       - name: Update vendored skills
         env:
-          SKILLS_UPDATE_REHOME: "1"
+          SKILLS_UPDATE_REHOME: '1'
         run: ./plugins/vendored/scripts/update-skills.sh
 
+      - name: Sync rn-skills lookup table
+        run: node ./packages/rn-skills/scripts/sync-lookup.mjs
+
       - name: Create pull request
         uses: peter-evans/create-pull-request@v7
         with:
           branch: automation/update-vendored-skills
-          commit-message: "chore: update vendored skills"
-          title: "chore: update vendored skills"
+          commit-message: 'chore: update vendored skills'
+          title: 'chore: update vendored skills'
           labels: enhancement
           body: |
             Automated nightly refresh of vendored skills.

packages/rn-skills/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+To refresh the skill catalog metadata used by the lookup table:
+
+```bash
+npm --prefix packages/rn-skills run sync:lookup
+```
+
+Existing entries in the [`lookup-table.json`](packages/rn-skills/src/lookup-table.json) will be kept, new ones will be added with default descriptions as in source repos - they need to be adjusted.

packages/rn-skills/README.md

@@ -0,0 +1,234 @@
+# rn-skills
+
+CLI for recommending and managing React Native agent skills from detected project dependencies, with curated mappings for common React Native libraries.
+
+It scans every `package.json` under the target directory, compares discovered libraries against a curated lookup table, and uses the [Vercel `skills` CLI](https://vercel.com/docs/agent-resources/skills) underneath to report, install, or remove relevant skills.
+
+## Installation
+
+Run it without installing permanently:
+
+```bash
+npx rn-skills
+```
+
+Or install it globally:
+
+```bash
+npm i -g rn-skills
+```
+
+## Commands
+
+```bash
+rn-skills
+rn-skills auto
+rn-skills report
+rn-skills interactive
+rn-skills list-supported
+```
+
+What each command does:
+
+- `rn-skills`: defaults to `auto`
+- `auto`: install all missing skills and remove extra managed RN skills without prompts
+- `report`: print detected libraries, recommended skills, missing skills, and extra managed RN skills without changing anything
+- `interactive`: print the same report and ask which missing skills to install and which extra skills to remove
+- `list-supported`: print the curated library-to-skill mappings bundled in the lookup table
+
+`auto` and `interactive` only remove skills managed by this CLI's lookup table. They do not remove unrelated installed skills.
+
+## Flags
+
+These flags are supported for all commands:
+
+```bash
+--cwd <path>   Scan and operate on a different project root
+--global       Compare against and modify global skills instead of project skills
+--no-remove    Keep extra managed skills installed; only add missing skills
+--no-mapping-update  Use the bundled local lookup table instead of fetching the latest one
+--help, -h     Print usage
+```
+
+`--no-remove` is useful with `auto` and `interactive` when you want recommendations and installs, but do not want the CLI to prune managed skills that are currently not needed by the detected dependencies.
+
+`--no-mapping-update` forces the CLI to use the packaged `lookup-table.json` instead of trying to fetch the latest version from GitHub. This is useful for offline or firewalled environments, deterministic local testing, and debugging.
+
+Examples:
+
+```bash
+rn-skills --help
+rn-skills report --cwd /path/to/repo
+rn-skills auto --global
+rn-skills auto --no-remove
+rn-skills report --no-mapping-update
+rn-skills list-supported
+```
+
+By default, the CLI attempts to fetch the newest lookup table from GitHub. If that fails, times out, or the downloaded JSON is invalid, it automatically falls back to the bundled local file.
+
+## Typical Usage
+
+Inspect recommendations without making changes:
+
+```bash
+rn-skills report --cwd /path/to/repo
+```
+
+Apply everything automatically:
+
+```bash
+rn-skills
+```
+
+Apply missing skills without removing currently installed managed ones:
+
+```bash
+rn-skills auto --no-remove
+```
+
+Use the packaged lookup table only:
+
+```bash
+rn-skills report --no-mapping-update
+```
+
+Review and choose interactively:
+
+```bash
+rn-skills interactive
+```
+
+See which libraries and skills are included in the curated mappings:
+
+```bash
+rn-skills list-supported
+```
+
+## Prior Art
+
+This tool uses the [Vercel `skills` CLI](https://vercel.com/docs/agent-resources/skills) under the hood.
+
+---
+
+## Made with ❤️ at Callstack
+
+This CLI is made by Callstack. Excluding ones maintained by Callstack, all other tools, libraries and skills, especially the Vercel `skills` CLI, are not related to Callstack in any way; their maintainers are not related to nor endorse this project.
+
+[Callstack](https://www.callstack.com/) is a group of React and React Native experts. Contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need help with performance optimization or just want to say hi!
+
+Like what we do? [Join the Callstack team](https://www.callstack.com/careers) and work on amazing React Native projects!
+
+# rn-skills
+
+CLI for recommending and managing React Native agent skills from detected project dependencies, with curated mappings for common React Native libraries, wrapping the [Vercel `skills` CLI](https://vercel.com/docs/agent-resources/skills) - which is used underneath this package.
+
+It scans every `package.json` under the target directory, compares discovered libraries against a curated lookup table, and uses the Vercel `skills` CLI to report, install, or remove relevant skills.
+
+## Installation
+
+Run it without installing permanently:
+
+```bash
+npx rn-skills
+```
+
+Or install it globally:
+
+```bash
+npm i -g rn-skills
+```
+
+## Commands
+
+```bash
+rn-skills
+rn-skills auto
+rn-skills report
+rn-skills interactive
+rn-skills list-supported
+```
+
+What each command does:
+
+- `rn-skills`: defaults to `auto`
+- `auto`: install all missing skills and remove extra managed RN skills without prompts
+- `report`: print detected libraries, recommended skills, missing skills, and extra managed RN skills without changing anything
+- `interactive`: print the same report and ask which missing skills to install and which extra skills to remove
+- `list-supported`: print the curated library-to-skill mappings bundled in the lookup table
+
+`auto` and `interactive` only remove skills managed by this CLI's lookup table. They do not remove unrelated installed skills.
+
+## Flags
+
+These flags are supported for all commands:
+
+```bash
+--cwd <path>   Scan and operate on a different project root
+--global       Compare against and modify global skills instead of project skills
+--no-remove    Keep extra managed skills installed; only add missing skills
+--no-mapping-update  Use the bundled local lookup table instead of fetching the latest one
+--help, -h     Print usage
+```
+
+`--no-remove` is useful with `auto` and `interactive` when you want recommendations and installs, but do not want the CLI to prune managed skills that are currently not needed by the detected dependencies.
+
+`--no-mapping-update` forces the CLI to use the packaged libraries-to-skills mapping instead of trying to fetch the latest version from GitHub. This is useful for offline or firewalled environments, deterministic local testing, and debugging.
+
+Examples:
+
+```bash
+rn-skills --help
+rn-skills report --cwd /path/to/repo
+rn-skills auto --global
+rn-skills auto --no-remove
+rn-skills list-supported
+```
+
+The CLI by default attempts to fetch the newest library-to-skills mapping when it is run from our repository. In case this fails, or the structure of the fetched file is unexpected (may happen if you installed the package and a new version with breaking changes is published in the meantime), the packaged .
+
+## Typical Usage
+
+Inspect recommendations without making changes:
+
+```bash
+rn-skills report --cwd /path/to/repo
+```
+
+Apply everything automatically:
+
+```bash
+rn-skills
+```
+
+Apply missing skills without removing currently installed managed ones:
+
+```bash
+rn-skills auto --no-remove
+```
+
+Review and choose interactively:
+
+```bash
+rn-skills interactive
+```
+
+See which libraries and skills are included in our curated mappings:
+
+```bash
+rn-skills list-supported
+```
+
+## Prior Art
+
+This tool uses the [Vercel `skills` CLI](https://vercel.com/docs/agent-resources/skills) under the hood.
+
+---
+
+## Made with ❤️ at Callstack
+
+This CLI is made by Callstack. Excluding ones maintained by Callstack, all other tools, libraries and skills - especially the Vercel `skills` CLI - are not related to Callstack in any way; their maintainers are not related nor endorse this project.
+
+[Callstack](https://www.callstack.com/) is a group of React and React Native experts. Contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need help with performance optimization or just want to say hi!
+
+Like what we do? ⚛️ [Join the Callstack team](https://www.callstack.com/careers) and work on amazing React Native projects!

packages/rn-skills/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "rn-skills",
+  "version": "0.1.0",
+  "description": "Suggests and manages React Native agent skills based on project dependencies.",
+  "type": "module",
+  "author": {
+    "name": "Callstack",
+    "email": "hello@callstack.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/callstackincubator/agent-skills.git",
+    "directory": "packages/rn-skills"
+  },
+  "homepage": "https://github.com/callstackincubator/agent-skills/tree/main/packages/rn-skills",
+  "bugs": {
+    "url": "https://github.com/callstackincubator/agent-skills/issues"
+  },
+  "bin": {
+    "rn-skills": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "colorette": "^2.0.20",
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "build": "mkdir -p dist && bun build src/index.ts --target=node --outfile dist/index.js",
+    "prepare": "bun run build",
+    "start": "bun run src/index.ts",
+    "sync:lookup": "node ./scripts/sync-lookup.mjs",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.11"
+  }
+}