feat: add Expo Skills to the curated lookup table

.changeset/tall-spies-invite.md

@@ -0,0 +1,5 @@
+---
+'pkg-skills': minor
+---
+
+feat: add Expo Skills (expo/skills) to the curated lookup table

LICENSE

@@ -115,4 +115,30 @@ SOFTWARE.
 https://github.com/vercel-labs/agent-skills
 
 _No LICENSE file found in the repository root._
+
+## expo/skills
+
+https://github.com/expo/skills
+
+The MIT License (MIT)
+
+Copyright (c) 2025-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 <!-- END:skill-repositories - do not modify -->

README.md

@@ -12,7 +12,7 @@ It scans every `package.json` under the target directory, compares discovered li
 ## Features
 
 - 🔍 **Dependency scan** — discovers libraries from every `package.json` under your project root
-- 🗺️ **Curated mappings** — links React Native packages to skills from Callstack, Software Mansion, Vercel, and more
+- 🗺️ **Curated mappings** — links React Native packages to skills from Callstack, Expo, Software Mansion, Vercel, and more
 - 📋 **Report** — shows recommended, missing, and extra skills without changing anything
 - 🙋 **Interactive** — choose action groups (update, install, remove), then pick skills in each
 - ⚡ **Auto** — updates, installs, and prunes managed skills in one non-interactive pass
@@ -219,6 +219,7 @@ This tool uses the following skills repositories:
 - [Software Mansion's Skills](https://github.com/software-mansion-labs/skills)
 - [React Native Testing Library Skills](https://github.com/callstack/react-native-testing-library)
 - [Vercel Agent Skills](https://github.com/vercel-labs/agent-skills)
+- [Expo Skills](https://github.com/expo/skills)
 <!-- END:skill-repositories - do not modify -->
 
 ## Special Thanks

scripts/sync-lookup.mjs

@@ -36,6 +36,22 @@ const remoteSources = [
     repo: 'vercel-labs/agent-skills',
     displayName: 'Vercel Agent Skills',
   },
+  {
+    repo: 'expo/skills',
+    displayName: 'Expo Skills',
+    skillsPath: 'plugins/expo/skills',
+    // expo-dom and expo-web-to-native are migration guides for code that has
+    // not adopted React Native yet, so no package.json signals them.
+    // expo-app-clip covers a feature almost no app ships, and
+    // expo-skill-feedback is a feedback and telemetry channel rather than
+    // engineering guidance - both would fire on every Expo project.
+    excludedSkills: [
+      'expo-app-clip',
+      'expo-dom',
+      'expo-skill-feedback',
+      'expo-web-to-native',
+    ],
+  },
 ];
 
 async function main() {
@@ -49,7 +65,10 @@ async function main() {
       skills: preserveExistingDescriptions(
         lookup,
         source.repo,
-        await fetchRemoteSkills(source.repo)
+        excludeSkills(
+          await fetchRemoteSkills(source.repo, source.skillsPath),
+          source.excludedSkills
+        )
       ),
     };
   }
@@ -83,9 +102,9 @@ async function main() {
   );
 }
 
-async function fetchRemoteSkills(repo) {
+async function fetchRemoteSkills(repo, skillsPath = 'skills') {
   const directoryResponse = await fetch(
-    `https://api.github.com/repos/${repo}/contents/skills`,
+    `https://api.github.com/repos/${repo}/contents/${skillsPath}`,
     {
       headers: {
         'Accept': 'application/vnd.github+json',
@@ -108,7 +127,7 @@ async function fetchRemoteSkills(repo) {
   const skills = [];
 
   for (const directory of directories) {
-    const rawSkillUrl = `https://raw.githubusercontent.com/${repo}/main/skills/${directory}/SKILL.md`;
+    const rawSkillUrl = `https://raw.githubusercontent.com/${repo}/main/${skillsPath}/${directory}/SKILL.md`;
     const response = await fetch(rawSkillUrl, {
       headers: {
         'User-Agent': 'pkg-skills-sync',
@@ -129,6 +148,14 @@ async function fetchRemoteSkills(repo) {
   return skills;
 }
 
+function excludeSkills(skills, excludedSkills) {
+  if (!excludedSkills?.length) {
+    return skills;
+  }
+
+  return skills.filter((skill) => !excludedSkills.includes(skill.name));
+}
+
 function preserveExistingDescriptions(lookup, repo, skills) {
   const existingDescriptionsBySkillName = new Map(
     (lookup.sources?.[repo]?.skills ?? []).map((skill) => [
@@ -262,7 +289,7 @@ function extractDescription(skillMarkdown) {
       inlineValue !== '>-' &&
       inlineValue !== '|-'
     ) {
-      return inlineValue;
+      return stripSurroundingQuotes(inlineValue);
     }
 
     const descriptionLines = [];
@@ -285,4 +312,15 @@ function extractDescription(skillMarkdown) {
   return '';
 }
 
+// YAML requires quoting a scalar that contains ': ', so some descriptions
+// arrive wrapped in delimiters that are not part of the text.
+function stripSurroundingQuotes(value) {
+  const quote = value[0];
+  if ((quote !== '"' && quote !== "'") || value.length < 2) {
+    return value;
+  }
+
+  return value.endsWith(quote) ? value.slice(1, -1) : value;
+}
+
 await main();