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,108 @@
+# 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
+--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.
+
+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
+```
+
+## 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,41 @@
+{
+  "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"
+  },
+  "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"
+  }
+}