autoskills

Auto-detect and install the best AI agent skills for your project. One command, zero config.

npx autoskills

autoskills scans your project, detects the technologies you use, and installs curated AI agent skills that make Cursor, Claude Code, and other AI coding assistants actually understand your stack.

Quick Start

Run it in your project root:

npx autoskills

That's it. It will:

1. Scan your package.json, config files, and project structure
2. Detect every technology in your stack
3. Show an interactive selector with the best skills for your project
4. Install them in parallel with live progress
5. Generate CLAUDE.md automatically when Claude Code is one of the target agents

Skip the prompt

npx autoskills -y

Preview without installing

npx autoskills --dry-run

Claude Code summary

If claude-code is auto-detected or passed with -a, autoskills writes a CLAUDE.md file in your project root summarizing the markdown files installed under .claude/skills.

Options

| Flag | Description | | ----------------- | ----------------------------------------------------- | | -y, --yes | Skip confirmation prompt, install all detected skills | | --dry-run | Show detected skills without installing anything | | -v, --verbose | Show install trace and error details | | -h, --help | Show help message |

Supported Technologies

autoskills detects 50+ technologies from your package.json, lockfiles, Gradle files, and config files:

Frameworks & Libraries

| Technology | Detected from | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | React | react, react-dom packages | | Next.js | next package or next.config.* | | Vue | vue package | | Nuxt | nuxt package or nuxt.config.* | | Svelte | svelte, @sveltejs/kit or svelte.config.js | | Angular | @angular/core or angular.json | | Astro | astro package or astro.config.* | | Expo | expo package | | React Native | react-native package | | Flutter | pubspec.yaml file with flutter: key | | Kotlin Multiplatform | Gradle with KMP plugin: kotlin("multiplatform"), org.jetbrains.kotlin.multiplatform, or kotlin-multiplatform in gradle/libs.versions.toml | | Android | Gradle with com.android.application, com.android.library, or com.android.kotlin.multiplatform.library | | Remotion | remotion, @remotion/cli | | GSAP | gsap package | | Three.js | three, @react-three/fiber, @react-three/drei | | Express | express package | | Hono | hono package | | NestJS | @nestjs/core package | | Spring Boot | Gradle with spring-boot-starter or org.springframework.boot | | ASP.NET Core | .csproj file with Microsoft.NET.Sdk.Web | | Blazor | .csproj with Microsoft.NET.Sdk.BlazorWebAssembly or Microsoft.AspNetCore.Components | | ASP.NET Minimal API | .csproj with Microsoft.AspNetCore.OpenApi or Swashbuckle.AspNetCore |

Styling & UI

| Technology | Detected from | | ------------ | --------------------------------------------------------- | | Tailwind CSS | tailwindcss, @tailwindcss/vite or tailwind.config.* | | shadcn/ui | components.json |

Runtimes & Tooling

| Technology | Detected from | | ---------- | ------------------------------------------------------------ | | TypeScript | typescript package or tsconfig.json | | Node.js | package-lock.json, yarn.lock, pnpm-lock.yaml, .nvmrc | | Bun | bun.lockb, bun.lock, bunfig.toml | | Deno | deno.json, deno.jsonc, deno.lock | | Dart | pubspec.yaml | | Go | go.mod, go.work | | Vite | vite package or vite.config.* | | Turborepo | turbo package or turbo.json | | Vitest | vitest package or vitest.config.* | | oxlint | oxlint package or .oxlintrc.json | | .NET | global.json, NuGet.Config, *.csproj, *.sln | | C# | *.csproj, *.sln |

Backend & Data

| Technology | Detected from | | --------------- | -------------------------------------------------------- | | Supabase | @supabase/supabase-js, @supabase/ssr | | Zod | zod package | | React Hook Form | react-hook-form package | | Neon Postgres | @neondatabase/serverless | | Prisma | prisma, @prisma/client | | Drizzle ORM | drizzle-orm, drizzle-kit | | Stripe | stripe, @stripe/stripe-js, @stripe/react-stripe-js | | Better Auth | better-auth package |

Authentication

| Technology | Detected from | | ---------- | --------------------------------------------------------------------------------------------------------------------- | | Clerk | @clerk/nextjs, @clerk/react, @clerk/expo, @clerk/astro, @clerk/remix, @clerk/vue, or any @clerk/* scope |

Cloud & Deploy

| Technology | Detected from | | ----------------- | ---------------------------------------------------- | | Vercel | vercel.json, .vercel/, @astrojs/vercel | | Cloudflare | wrangler, wrangler.toml, @astrojs/cloudflare | | Cloudflare Agents | agents package | | Cloudflare AI | @cloudflare/ai or AI binding in wrangler.json | | Durable Objects | durable_objects in wrangler.json/wrangler.toml | | Azure | @azure/* packages | | AWS | @aws-sdk/*, aws-cdk* packages |

AI

| Technology | Detected from | | ------------- | ------------------------------------------------------------- | | Vercel AI SDK | ai, @ai-sdk/openai, @ai-sdk/anthropic, @ai-sdk/google | | ElevenLabs | elevenlabs package |

Other

| Technology | Detected from | | ---------- | ------------------------------------------------------------------------------------------- | | Playwright | @playwright/test, playwright or playwright.config.* | | SwiftUI | Package.swift | | WordPress | wp-config.php, @wordpress/*, composer.json with wpackagist, theme style.css | | Tauri | @tauri-apps/api, @tauri-apps/cli or src-tauri/tauri.conf.json | | Electron | electron package, electron-builder.yml, forge.config.js, or electron-vite.config.ts |

Web Frontend Detection

Even without a framework, autoskills scans your file tree for web frontend signals (.html, .css, .scss, .vue, .svelte, .jsx, .tsx, .twig, .blade.php, etc.) and installs skills for frontend design, accessibility, and SEO.

Combo Detection

When multiple technologies are used together, autoskills detects technology combos and adds specialized skills for the combination:

• Next.js + Supabase — Supabase Postgres best practices for Next.js
• Next.js + Vercel AI SDK — AI SDK patterns with Next.js
• Next.js + Playwright — E2E testing best practices for Next.js
• React + shadcn/ui — shadcn component patterns with React
• Tailwind CSS + shadcn/ui — Tailwind v4 + shadcn integration
• Expo + Tailwind CSS — Tailwind setup for Expo
• React Native + Expo — Native UI patterns
• React Hook Form + Zod — Form validation patterns with Zod schemas
• GSAP + React — GSAP animation patterns in React
• Cloudflare + Vite — Vinext migration guide
• Node.js + Express — Express server patterns

How It Works

autoskills uses skills.sh under the hood — the open skill registry for AI coding agents. Skills are markdown files that teach AI assistants how to work with specific technologies, following best practices and patterns from the official maintainers.

The detection runs entirely locally with zero network requests until installation begins.

Requirements

• Node.js >= 22.0.0

License

CC-BY-NC-4.0 — Created by @midudev