skill-sync

Scan your codebase and discover OpenSkills to install based on your dependencies.

Features

• Scans package.json for dependencies (supports monorepo workspaces)
• Detects configuration files (Next.js, Tailwind, Prisma, etc.)
• Maps detected technologies to relevant OpenSkills
• Interactive skill selection with @clack/prompts
• Installs skills via the openskills CLI

Requirements

This project requires Bun v1.3.3 or higher.

Usage

Interactive Mode (default)

npx @danielterwiel/skill-sync

This will:

1. Scan your project for dependencies and config files
2. Show you a list of matching skills
3. Let you select which skills to install
4. Install the selected skills

Auto Mode

Install all detected skills without prompting:

npx @danielterwiel/skill-sync --auto

Options

--cwd <path>    Project directory to scan (default: current directory)
--auto, -a      Install all detected skills without prompting
--quiet, -q     Suppress output
--help, -h      Show help message
--version, -v   Show version

Programmatic API

import { scanSkills, installSkills } from "@danielterwiel/skill-sync";

// Scan for matching skills
const result = await scanSkills("./my-project");
console.log(result.skills);
// [
//   { skill: 'nextjs', source: 'secondsky/claude-skills/...', reason: 'detected via next' },
//   { skill: 'tailwind-v4-shadcn', source: '...', reason: 'detected via tailwindcss' },
// ]

// Install specific skills
const installResult = await installSkills(result.skills, "./my-project");
console.log(
  `Installed: ${installResult.installed}, Failed: ${installResult.failed}`,
);

Supported Technologies

The scanner recognizes 100+ packages and frameworks including:

Frameworks: TanStack Start, Next.js, Expo, Astro, Nuxt, SvelteKit, Hono, Elysia Styling: Tailwind CSS, shadcn/ui, Styled Components, Emotion Databases: Prisma, Drizzle, Supabase, Firebase, MongoDB, PostgreSQL Auth: Clerk, Better Auth, NextAuth, Auth0 Testing: Vitest, Jest, Playwright, Cypress And many more...

License

MIT