@ericrisco/rsc 1.0.27 → 1.0.29

package/README.md

@@ -1,8 +1,8 @@
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/ericrisco/rsc-harness/main/site/og.png" alt="rsc — your agent needs a memory (02-DOCS/, or it invents what it cannot remember), arms (01-TOOLS/, or it never touches your database), a trade (264 skills, or it guesses how the job is done), and reflexes (deterministic hooks, or it forgets the rule mid-session). One meta-harness for 17 coding assistants." width="960">
+<img src="https://raw.githubusercontent.com/ericrisco/rsc-harness/main/site/og.png" alt="rsc — your agent needs a memory (02-DOCS/, or it invents what it cannot remember), arms (01-TOOLS/, or it never touches your database), a trade (276 skills, or it guesses how the job is done), and reflexes (deterministic hooks, or it forgets the rule mid-session). One meta-harness for 17 coding assistants." width="960">
 
-# `rsc` — 264 agent skills, one CLI, zero bloat
+# `rsc` — 276 agent skills, one CLI, zero bloat
 
 [![npm](https://img.shields.io/npm/v/@ericrisco/rsc?color=63d68a&labelColor=12161c&label=npm)](https://www.npmjs.com/package/@ericrisco/rsc)
 [![downloads](https://img.shields.io/npm/dm/@ericrisco/rsc?color=63d68a&labelColor=12161c&label=downloads)](https://www.npmjs.com/package/@ericrisco/rsc)
@@ -344,11 +344,11 @@ Train and adapt open models end to end: classic ML, deep learning, NLP, fine-tun
 
 ### 🗣️ Languages
 
-[typescript](skills/typescript/) · [python](skills/python/) · [java](skills/java/) · [csharp-dotnet](skills/csharp-dotnet/) · [php](skills/php/) · [ruby](skills/ruby/) · [cpp](skills/cpp/) · [elixir](skills/elixir/) · [bash-scripting](skills/bash-scripting/) · [sql](skills/sql/) · [go](skills/go/)
+[typescript](skills/typescript/) · [python](skills/python/) · [java](skills/java/) · [csharp-dotnet](skills/csharp-dotnet/) · [php](skills/php/) · [ruby](skills/ruby/) · [cpp](skills/cpp/) · [elixir](skills/elixir/) · [bash-scripting](skills/bash-scripting/) · [sql](skills/sql/) · [go](skills/go/) · [write-swift](skills/write-swift/)
 
 ### 🏗️ Frameworks & app stacks
 
-[fastapi](skills/fastapi/) · [nextjs](skills/nextjs/) · [react](skills/react/) · [react-native](skills/react-native/) · [vue-nuxt](skills/vue-nuxt/) · [angular](skills/angular/) · [svelte](skills/svelte/) · [astro](skills/astro/) · [solid-js](skills/solid-js/) · [htmx](skills/htmx/) · [nodejs](skills/nodejs/) · [nestjs](skills/nestjs/) · [django](skills/django/) · [laravel](skills/laravel/) · [rails](skills/rails/) · [spring-boot](skills/spring-boot/) · [phoenix](skills/phoenix/) · [flutter](skills/flutter/) · [swift-ios](skills/swift-ios/) · [kotlin-android](skills/kotlin-android/) · [compose-multiplatform](skills/compose-multiplatform/) · [expo](skills/expo/) · [tauri](skills/tauri/) · [electron](skills/electron/) · [rust](skills/rust/) · [wordpress](skills/wordpress/) · [shopify](skills/shopify/) · [no-code-app](skills/no-code-app/) · [chrome-extension](skills/chrome-extension/) · [api-design](skills/api-design/)
+[fastapi](skills/fastapi/) · [nextjs](skills/nextjs/) · [react](skills/react/) · [react-native](skills/react-native/) · [vue-nuxt](skills/vue-nuxt/) · [angular](skills/angular/) · [svelte](skills/svelte/) · [astro](skills/astro/) · [solid-js](skills/solid-js/) · [htmx](skills/htmx/) · [nodejs](skills/nodejs/) · [nestjs](skills/nestjs/) · [django](skills/django/) · [laravel](skills/laravel/) · [rails](skills/rails/) · [spring-boot](skills/spring-boot/) · [phoenix](skills/phoenix/) · [flutter](skills/flutter/) · [swift-ios](skills/swift-ios/) · [kotlin-android](skills/kotlin-android/) · [compose-multiplatform](skills/compose-multiplatform/) · [expo](skills/expo/) · [tauri](skills/tauri/) · [electron](skills/electron/) · [rust](skills/rust/) · [wordpress](skills/wordpress/) · [shopify](skills/shopify/) · [no-code-app](skills/no-code-app/) · [chrome-extension](skills/chrome-extension/) · [api-design](skills/api-design/) · [pick-ui-library](skills/pick-ui-library/) · [ask-sonner](skills/ask-sonner/)
 
 ### 🎮 Game development
 
@@ -372,6 +372,10 @@ Three engines + engine-agnostic disciplines. Every engine skill pins the current
 
 [code-review](skills/code-review/) · [security-scan](skills/security-scan/) · [secure-coding](skills/secure-coding/) · [testing-py](skills/testing-py/) · [testing-web](skills/testing-web/) · [testing-go](skills/testing-go/) · [e2e-testing](skills/e2e-testing/) · [accessibility](skills/accessibility/) · [performance](skills/performance/) · [error-handling](skills/error-handling/) · [observability](skills/observability/)
 
+### 🌀 Motion & interface craft
+
+[design-eng](skills/design-eng/) · [animate](skills/animate/) · [animate-expo](skills/animate-expo/) · [review-animations](skills/review-animations/) · [improve-animations](skills/improve-animations/) · [find-animation-opportunities](skills/find-animation-opportunities/) · [animation-vocabulary](skills/animation-vocabulary/) · [apple-design](skills/apple-design/) · [prototype](skills/prototype/)
+
 ### 🎨 Design & content craft
 
 [design](skills/design/) · [presentations](skills/presentations/) · [course-storytelling](skills/course-storytelling/) · [course-builder](skills/course-builder/) · [technical-writing](skills/technical-writing/) · [translation-l10n](skills/translation-l10n/)
@@ -455,6 +459,20 @@ the rubric to hold it to is `scripts/skill-rubric.md`.
 This is a personal catalog. Bug reports welcome via GitHub issues; PRs fixing
 detector patterns, provider endpoints, or typos are appreciated.
 
+## Third-party skills
+
+Most of this catalog is written here. These are not, and they keep their author's credit:
+
+| Skills | Source | License |
+| --- | --- | --- |
+| `design-eng` · `animate` · `animate-expo` · `review-animations` · `improve-animations` · `find-animation-opportunities` · `animation-vocabulary` · `apple-design` · `prototype` · `pick-ui-library` · `write-swift` · `ask-sonner` | [emilkowalski/skills](https://github.com/emilkowalski/skills) by Emil Kowalski, commit `d23d7f8` | MIT |
+| part of the AI-tell corpus in `design` | [Leonxlnx/taste-skill](https://github.com/Leonxlnx/taste-skill) | MIT |
+
+Adapted, not mirrored: each one carries rsc frontmatter, routing evals, hand-offs to its siblings
+and — where it declares a binding rule — a checker with a test. The craft bar in them is the
+original author's. If you want the source of the motion material rather than this adaptation, go to
+[animations.dev](https://animations.dev/).
+
 ## License
 
 MIT. See [LICENSE](LICENSE).

package/manifest.json

@@ -1,7 +1,7 @@
 {
-  "version": "1.0.27",
+  "version": "1.0.29",
   "counts": {
-    "skills": 264
+    "skills": 276
   },
   "skills": [
     {
@@ -182,6 +182,62 @@
       ],
       "profiles": []
     },
+    {
+      "id": "animate",
+      "description": "Build a web animation: whether it should animate at all, the purpose, the tool, the properties, the easing curve, the duration, interruption and exit. Writes the CSS or Motion code for dropdowns, modals, toasts, tooltips, accordions, press feedback, stagger and scroll reveals. Use to animate something or make a component feel alive.",
+      "tags": [
+        "motion",
+        "animation",
+        "css",
+        "transitions",
+        "ui"
+      ],
+      "recommends": [
+        "review-animations",
+        "pick-ui-library",
+        "apple-design"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
+    {
+      "id": "animate-expo",
+      "description": "Build animation and gestures in React Native and Expo with Reanimated worklets on the UI thread — sheets, drawers, screen transitions, swipe, drag, press feedback, haptics. Use when adding gestures to an Expo app, or when motion stutters, janks or drops frames on a real Android or iOS device.",
+      "tags": [
+        "motion",
+        "animation",
+        "expo",
+        "react-native",
+        "gestures"
+      ],
+      "recommends": [
+        "expo",
+        "react-native",
+        "animate"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
+    {
+      "id": "animation-vocabulary",
+      "description": "Reverse glossary: turn a vague description of a motion effect into its exact name — a popover growing from its trigger is origin-aware, iOS overscroll is rubber-banding, items appearing one after another with a delay is a stagger. Use for \\\"what's it called when…\\\" or \\\"what do you call it when…\\\".",
+      "tags": [
+        "motion",
+        "animation",
+        "glossary",
+        "terminology",
+        "naming"
+      ],
+      "recommends": [
+        "animate",
+        "apple-design"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "api-connector-builder",
       "description": "Use when writing a client for someone else's REST or GraphQL API: auth flow choice and token refresh, pagination to exhaustion, retry-with-jitter on transient failures only, rate-limit-aware throttling. NOT inbound callbacks (that is `webhooks`), NOT chaining services (that is `automation-flows`), NOT designing your own API (that is `api-design`).",
@@ -233,6 +289,25 @@
       ],
       "profiles": []
     },
+    {
+      "id": "apple-design",
+      "description": "Apple's fluid-interface craft on the web: spring damping and response, velocity handoff, momentum projection on a flick, rubber-banding at a boundary, interruptible motion the user can grab mid-flight, translucent materials and backdrop blur, letter-spacing and leading by size. Use for iOS-grade feel, sheets and drag.",
+      "tags": [
+        "design",
+        "motion",
+        "springs",
+        "gestures",
+        "apple"
+      ],
+      "recommends": [
+        "animate",
+        "design",
+        "swift-ios"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "article-writing",
       "description": "Use when writing one long-form article end to end — answer-first lede, question-shaped headings, plus its on-page surface (title, meta, slug, FAQ, Article/FAQPage JSON-LD) — or fixing a draft that buries the answer or reads AI-padded. NOT keyword research or topic selection (that is `seo-geo`), NOT the editorial calendar (that is `content-engine`).",
@@ -256,6 +331,25 @@
       ],
       "profiles": []
     },
+    {
+      "id": "ask-sonner",
+      "description": "Sonner, the React toast library: mounting Toaster once, toast() calls, promise and loading toasts, updating, dismissing, styling, theming, dark mode, positioning. Use when toasts do not appear, appear twice, sit behind a modal, ignore Tailwind classes, or do nothing from a server action.",
+      "tags": [
+        "sonner",
+        "toasts",
+        "notifications",
+        "react",
+        "library"
+      ],
+      "recommends": [
+        "react",
+        "nextjs",
+        "pick-ui-library"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "astro",
       "description": "Use when building a content-driven or marketing site with Astro 6: static-first pages, islands and partial hydration, content collections, server islands, per-route on-demand rendering, deploy adapters, and Astro 5→6 migration. NOT app-router React with server actions and heavy client interactivity (that is `nextjs`).",
@@ -1315,6 +1409,27 @@
       ],
       "profiles": []
     },
+    {
+      "id": "design-eng",
+      "description": "Umbrella for frontend craft: routes a UI request to the sibling that owns it — build motion, review it, audit it, find where it is missing, name an effect, gesture physics, prototype variants, pick a library. Use when an app works but feels cheap or unpolished, or when a frontend request could belong to several of them.",
+      "tags": [
+        "design",
+        "frontend",
+        "ui",
+        "routing",
+        "craft"
+      ],
+      "recommends": [
+        "animate",
+        "review-animations",
+        "apple-design",
+        "design"
+      ],
+      "profiles": [
+        "core",
+        "full"
+      ]
+    },
     {
       "id": "digitalocean",
       "description": "Use when deploying or operating a workload on DigitalOcean — Droplet vs App Platform vs Functions, doctl, app spec YAML, Managed Postgres/MySQL/Valkey on the VPC, S3-compatible Spaces + CDN. NOT host-agnostic CI/CD or rollback strategy (that is `deployment`), NOT a bare Hetzner VPS (that is `hetzner`), NOT another managed PaaS (that is `railway`).",
@@ -1790,6 +1905,24 @@
       ],
       "profiles": []
     },
+    {
+      "id": "find-animation-opportunities",
+      "description": "Sweep a UI for what does not animate but should, and reject what should not — each suggestion with an exact curve and duration, plus the rejected candidates. Read-only. Use for 'what could be animated here', 'where would motion help', or an interface that feels static and dead.",
+      "tags": [
+        "motion",
+        "animation",
+        "restraint",
+        "opportunities",
+        "ui"
+      ],
+      "recommends": [
+        "animate",
+        "improve-animations"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "finetuning",
       "description": "Use when adapting an open-weight model to a target form or behavior — tone, output format, reasoning pattern — via LoRA/QLoRA or full fine-tuning with TRL SFTTrainer, then preference optimization (DPO/ORPO/KTO/GRPO), and for fine-tune vs prompt vs RAG. NOT adding facts to a model (that is rag); NOT the single-GPU Unsloth backend or GGUF export (that is unsloth).",
@@ -2383,6 +2516,25 @@
         "full"
       ]
     },
+    {
+      "id": "improve-animations",
+      "description": "Audit a whole codebase's animation and motion, then write prioritized findings and self-contained plans another agent can execute. Read-only. Use for 'improve the animations', 'make the app feel better', or a roadmap of motion fixes — rather than a verdict on one diff.",
+      "tags": [
+        "motion",
+        "animation",
+        "audit",
+        "plan",
+        "codebase"
+      ],
+      "recommends": [
+        "review-animations",
+        "animate",
+        "plan"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "init",
       "description": "Use when starting from nothing or pointing rsc at an existing project — the front door. Gauges technical level and the accompaniment dial first (non-technical by default), discovers what the user wants to build or govern (any stack, or a non-code harness: company/ops, research, knowledge, content), writes the profile to 02-DOCS, and installs the skills discovery justified. NOT the scaffolder (that is `harness`), NOT a stack skill.",
@@ -3458,6 +3610,25 @@
       ],
       "profiles": []
     },
+    {
+      "id": "pick-ui-library",
+      "description": "Pick the frontend library for a task from a curated list: dialogs and popovers, command palette, toasts, one-time-password input, charts, virtualization, drag and drop, state, conditional classNames, variants, dark mode. Use instead of hand-rolling a component or installing an abandoned package.",
+      "tags": [
+        "frontend",
+        "libraries",
+        "dependencies",
+        "react",
+        "ui"
+      ],
+      "recommends": [
+        "react",
+        "nextjs",
+        "animate"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "pitch-deck",
       "description": "Use when building or fixing an investor fundraising deck — the narrative arc, the slide-by-slide story, and the few numbers that actually move an investment decision, for a pre-seed, seed or Series A raise (or an accelerator application deck). Decides what goes on each slide, in what order, with which metric, sequenced the way an investor evaluates risk. NOT rendering, theming or exporting the slides into a designed PDF or PPTX (that is `presentations`), NOT the projection spreadsheet behind the numbers (that is `financial-model`).",
@@ -3732,6 +3903,25 @@
       ],
       "profiles": []
     },
+    {
+      "id": "prototype",
+      "description": "Build several genuinely different versions — variants, takes, options, directions — of one UI piece behind a visual picker, so you flip through them live and promote the winner. Use to explore a look before committing, or when you do not yet know what you want something to look like.",
+      "tags": [
+        "design",
+        "variants",
+        "exploration",
+        "picker",
+        "ui"
+      ],
+      "recommends": [
+        "design",
+        "animate",
+        "nextjs"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "python",
       "description": "Use when the task is Python itself, in any framework or none: PEP 695 generics, mypy --strict typing, dataclass/Protocol/TypedDict/Enum choices, asyncio.TaskGroup, stdlib idioms, src/ layout + pyproject.toml with uv, ruff+mypy+pytest gate. NOT a FastAPI/ASGI service (that is fastapi), NOT a deep pytest suite (that is testing-py).",
@@ -4060,6 +4250,25 @@
         "full"
       ]
     },
+    {
+      "id": "review-animations",
+      "description": "Review, critique or grade existing animation and motion code against a strict craft bar — easing, duration, transform-origin, interruptibility, GPU-only properties, reduced motion, enter/exit asymmetry, stagger. Default is to flag; approval is earned. Use on the transitions in a diff or a component.",
+      "tags": [
+        "motion",
+        "animation",
+        "review",
+        "craft",
+        "ui"
+      ],
+      "recommends": [
+        "animate",
+        "improve-animations",
+        "code-review"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "review-management",
       "description": "Use when a public review needs an on-voice reply, when you need to earn more reviews legally, or when an aggregate rating is slipping across Google Business Profile, Trustpilot, the App Store or Google Play — including deciding reply versus flag, getting an unfair one-star removed rather than merely answered, and wiring programmatic replies. NOT a private support ticket against an SLA (that is `customer-support`), NOT churn, NPS or save plays (that is `retention`).",
@@ -5370,6 +5579,25 @@
         "full"
       ]
     },
+    {
+      "id": "write-swift",
+      "description": "Modern Swift at the language level: structs and value types versus classes, Swift 6 data-race safety, actors, async/await and task groups, `some` versus `any`, ARC and retain cycles, Swift Testing, macros. Use for a deadlock, a hang, a data race, a concurrency error, or migrating to Swift 6.",
+      "tags": [
+        "swift",
+        "language",
+        "concurrency",
+        "generics",
+        "testing"
+      ],
+      "recommends": [
+        "swift-ios",
+        "apple-design",
+        "testing-web"
+      ],
+      "profiles": [
+        "full"
+      ]
+    },
     {
       "id": "youtube-api",
       "description": "Use when wiring code to a real YouTube channel: user OAuth 2.0, resumable videos.insert uploads, editing metadata after publish, pulling views/watch time/retention/traffic from the Analytics API v2 into a dated 02-DOCS/wiki/youtube/ feedback log. NOT what to publish or how to title and thumbnail it (that is youtube-strategy / youtube-packaging).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ericrisco/rsc",
-  "version": "1.0.27",
+  "version": "1.0.29",
   "description": "Eric Risco's agent-skills catalog as a granular, self-recommending CLI installer.",
   "type": "module",
   "bin": {

package/scripts/detect-repo.js

@@ -1,13 +1,39 @@
 import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 
+// What counts as a frontend, and which stack skill owns it. Before this table, "frontend" meant
+// React or Next and nothing else, so a Vue/Svelte/Astro/Angular/Solid repo got no design skill at
+// all — even though the catalog ships a skill for each of them. Every entry here also earns the
+// `design-eng` umbrella, which is the one skill that routes a UI request to the sibling that owns
+// it. Kept as a table, not a chain of `if`s, so adding a framework is one line and the test
+// iterates it. Spec: 02-DOCS/wiki/sdd/specs/motion-craft-skills.md
+const FRONTEND_DEPS = [
+  ['next', 'nextjs'],
+  ['react', 'nextjs'],
+  ['vue', 'vue-nuxt'],
+  ['nuxt', 'vue-nuxt'],
+  ['svelte', 'svelte'],
+  ['@sveltejs/kit', 'svelte'],
+  ['astro', 'astro'],
+  ['@angular/core', 'angular'],
+  ['solid-js', 'solid-js'],
+];
+
 export function detectRepo(dir = process.cwd()) {
   const found = new Set();
   const has = (f) => existsSync(join(dir, f));
   const pkg = has('package.json') ? safeJson(join(dir, 'package.json')) : null;
   if (pkg) {
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-    if (deps.next || deps.react) { found.add('nextjs'); found.add('design'); }
+    for (const [dep, stack] of FRONTEND_DEPS) {
+      if (!deps[dep]) continue;
+      found.add(stack);
+      found.add('design');
+      // The umbrella, not a motion skill: it decides which of the craft siblings answers. A repo
+      // that never animates anything still benefits from the routing, and one that does gets sent
+      // to the right place instead of having `design` guess.
+      found.add('design-eng');
+    }
   }
   if (has('pubspec.yaml')) { found.add('flutter'); found.add('design'); }
   if (has('requirements.txt') || has('pyproject.toml')) found.add('fastapi');

package/scripts/drift-check.js

@@ -146,18 +146,50 @@ export function basesFor(docPath, { mode, root }) {
   return [dirname(docPath), root, join(root, '02-DOCS'), join(root, '02-DOCS', 'wiki'), join(root, 'skills')];
 }
 
-const resolves = (target, bases) => bases.some((b) => existsSync(resolve(b, target)));
+// `existsSync` asks the filesystem, and on APFS/HFS+ (macOS) and NTFS (Windows) the filesystem
+// ignores case. So a link to `AUDIT.md` resolves against a file named `audit.md` and this gate goes
+// GREEN on the maintainer's machine while Linux CI — and every installed user — sees a broken link.
+// That is P2 in its most expensive form: the gate fails open exactly where the work is done. It
+// happened for real (the motion-craft port moved references and one link kept its old casing).
+//
+// So existence is checked one path segment at a time against the parent's actual directory listing,
+// which is byte-exact on every filesystem. The walk starts at `root`, which is real by
+// construction; the declared hole is a target that resolves OUTSIDE the repo, where there is no
+// listing we can trust — the repo's own path may sit under a differently-cased volume or behind a
+// symlink, and a false positive in a blocking gate costs more than a named gap.
+// Spec: 02-DOCS/wiki/sdd/specs/drift-check-case.md
+function existsExact(absTarget, root, cache) {
+  const rel = relative(root, absTarget);
+  // Outside the repo (or the root itself): keep the old behaviour, and say so rather than guess.
+  if (rel === '' || rel.startsWith('..') || rel.startsWith('/')) return existsSync(absTarget);
+
+  let dir = root;
+  for (const segment of rel.split('/')) {
+    let entries = cache.get(dir);
+    if (entries === undefined) {
+      // An unreadable directory is not evidence of drift; fall back rather than accuse.
+      try { entries = new Set(readdirSync(dir)); } catch { return existsSync(absTarget); }
+      cache.set(dir, entries);
+    }
+    if (!entries.has(segment)) return false;
+    dir = join(dir, segment);
+  }
+  return true;
+}
+
+const resolves = (target, bases, root, cache) =>
+  bases.some((b) => existsExact(resolve(b, target), root, cache));
 
 // Knowledge mode only. The authoring standards write per-skill paths generically — "every skill
 // carries `evals/cases.yaml`" — which is a claim about a shape shared by 258 directories, not a
 // location. Resolving it against any one skill is the honest reading; treating it as drift
 // produced five findings that were never wrong.
-function resolvesInAnySkill(target, root) {
+function resolvesInAnySkill(target, root, cache) {
   if (target.startsWith('.') || target.startsWith('/')) return false;
   const skillsDir = join(root, 'skills');
   if (!existsSync(skillsDir)) return false;
   for (const e of readdirSync(skillsDir, { withFileTypes: true })) {
-    if (e.isDirectory() && existsSync(join(skillsDir, e.name, target))) return true;
+    if (e.isDirectory() && existsExact(join(skillsDir, e.name, target), root, cache)) return true;
   }
   return false;
 }
@@ -186,6 +218,9 @@ export function scanTree(dir, { mode, root = REPO, label = null } = {}) {
   const findings = [];
   let claims = 0;
   let skipped = 0;
+  // Directory listings, memoized per scan rather than per module: 824 claims share a few hundred
+  // directories, and a cache that outlived the scan would answer from a stale listing.
+  const cache = new Map();
   for (const doc of markdownFiles(dir)) {
     const text = readFileSync(doc, 'utf8');
     const raw = mode === 'catalog'
@@ -199,8 +234,8 @@ export function scanTree(dir, { mode, root = REPO, label = null } = {}) {
         continue;
       }
       claims++;
-      if (mode === 'knowledge' && resolvesInAnySkill(c.target, root)) continue;
-      if (!resolves(c.target, bases)) {
+      if (mode === 'knowledge' && resolvesInAnySkill(c.target, root, cache)) continue;
+      if (!resolves(c.target, bases, root, cache)) {
         findings.push({
           doc: relative(root, doc),
           line: c.line,

package/scripts/lib/domains.js

@@ -17,13 +17,14 @@ export const DOMAINS = [
   { title: 'AI — build it in', ids: ['building-agents', 'rag', 'embeddings-search', 'prompt-engineering', 'llm-pipeline', 'agent-eval', 'chatbot', 'ai-media', 'replicate-images', 'structured-extraction', 'agent-safety', 'cost-tracking'] },
   { title: 'AI — run it on', ids: ['replicate', 'runpod', 'modal', 'huggingface', 'ollama', 'together-fireworks', 'fal'] },
   { title: 'AI — train it', ids: ['machine-learning', 'deep-learning', 'nlp', 'finetuning', 'training-data', 'unsloth', 'open-weights', 'vllm'] },
-  { title: 'Languages', ids: ['typescript', 'python', 'java', 'csharp-dotnet', 'php', 'ruby', 'cpp', 'elixir', 'bash-scripting', 'sql', 'go'] },
-  { title: 'Frameworks & app stacks', ids: ['fastapi', 'nextjs', 'react', 'react-native', 'vue-nuxt', 'angular', 'svelte', 'astro', 'solid-js', 'htmx', 'nodejs', 'nestjs', 'django', 'laravel', 'rails', 'spring-boot', 'phoenix', 'flutter', 'swift-ios', 'kotlin-android', 'compose-multiplatform', 'expo', 'tauri', 'electron', 'rust', 'wordpress', 'shopify', 'no-code-app', 'chrome-extension', 'api-design'] },
+  { title: 'Languages', ids: ['typescript', 'python', 'java', 'csharp-dotnet', 'php', 'ruby', 'cpp', 'elixir', 'bash-scripting', 'sql', 'go', 'write-swift'] },
+  { title: 'Frameworks & app stacks', ids: ['fastapi', 'nextjs', 'react', 'react-native', 'vue-nuxt', 'angular', 'svelte', 'astro', 'solid-js', 'htmx', 'nodejs', 'nestjs', 'django', 'laravel', 'rails', 'spring-boot', 'phoenix', 'flutter', 'swift-ios', 'kotlin-android', 'compose-multiplatform', 'expo', 'tauri', 'electron', 'rust', 'wordpress', 'shopify', 'no-code-app', 'chrome-extension', 'api-design', 'pick-ui-library', 'ask-sonner'] },
   { title: 'Game development', ids: ['godot', 'unity', 'unreal', 'game-design', 'game-storytelling', 'level-design', 'gamedev-shaders', 'gamedev-multiplayer', 'gamedev-physics', 'gamedev-pathing', 'gamedev-shipping'] },
   { title: 'Databases & data layer', ids: ['postgresdb', 'mysql', 'mongodb', 'redis', 'supabase', 'neon', 'planetscale', 'sqlite-turso', 'prisma-orm', 'drizzle-orm', 'firebase', 'dynamodb', 'vector-db', 'clickhouse-analytics', 'duckdb', 'db-migrations', 'backups'] },
   { title: 'Ship & operate — platforms', ids: ['vercel', 'netlify', 'cloudflare', 'railway', 'render', 'fly-io', 'coolify', 'hetzner', 'digitalocean', 'aws-essentials', 'gcp-essentials'] },
   { title: 'Ship & operate — devops', ids: ['docker', 'github-actions', 'git-workflow', 'domains-dns', 'monitoring', 'email-deliverability', 'scaling', 'deployment', 'deprecation'] },
   { title: 'Ship & operate — quality & security', ids: ['code-review', 'security-scan', 'secure-coding', 'testing-py', 'testing-web', 'testing-go', 'e2e-testing', 'accessibility', 'performance', 'error-handling', 'observability'] },
+  { title: 'Motion & interface craft', ids: ['design-eng', 'animate', 'animate-expo', 'review-animations', 'improve-animations', 'find-animation-opportunities', 'animation-vocabulary', 'apple-design', 'prototype'] },
   { title: 'Design & content craft', ids: ['design', 'presentations', 'course-storytelling', 'course-builder', 'technical-writing', 'translation-l10n'] },
   { title: 'Knowledge & meta', ids: ['knowledge-ops', 'codebase-onboarding', 'research-ops', 'decision-records', 'continuous-learning', 'skill-scout', 'context-budget', 'roast-me', 'fable-operator'] },
 ];