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

$3

``bash
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

$3

Install all detected skills without prompting:

`bash
npx @danielterwiel/skill-sync --auto
`

$3

`
--cwd 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

`typescript
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