{"_id":"@aidlc-factory/autoskills","name":"@aidlc-factory/autoskills","dist-tags":{"latest":"0.3.6"},"versions":{"0.3.6":{"name":"@aidlc-factory/autoskills","version":"0.3.6","description":"Auto-detect and install the best AI agent skills for your project","keywords":["agent","ai","auto","claude","cli","copilot","cursor","detect","skills"],"homepage":"https://github.com/Mbg999/autoskills-for-aidlc-factory","license":"CC-BY-NC-4.0","author":{"name":"Mbg999"},"repository":{"type":"git","url":"git+https://github.com/Mbg999/autoskills-for-aidlc-factory.git"},"bin":{"autoskills":"index.mjs"},"type":"module","scripts":{"build":"tsc","test":"node --test 'tests/*.test.ts'","validate:registry":"node scripts/validate-registry.mjs","prepublishOnly":"pnpm run validate:registry","release":"node scripts/release.mjs","sync:skills":"node --experimental-strip-types --disable-warning=ExperimentalWarning scripts/sync-skills.mjs"},"devDependencies":{"@types/node":"22.15.3","typescript":"5.8.3"},"engines":{"node":">=22.6.0"},"_id":"@aidlc-factory/autoskills@0.3.6","gitHead":"bebe4eb77af46b3ca9aebed830b38e900f536ba5","bugs":{"url":"https://github.com/Mbg999/autoskills-for-aidlc-factory/issues"},"_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-8YBRCwi8Rj0FCM8SNcud4G0qUDKE6ckk8Ywt2y1Ou3doBNrOvspIFO3M1TsnT/71GZnPvUnoTgeApRkb30WjXg==","shasum":"5730a4916b4fac357a4cca6cf2c1a4226745b6e9","tarball":"https://registry.npmjs.org/@aidlc-factory/autoskills/-/autoskills-0.3.6.tgz","fileCount":11,"unpackedSize":1162841,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF9qBnQiS77u3GlkST2HgYtkEMR0F3f2zIjUj34eqs/LAiEA1kxg1I02QA+T3vjqGm0CDWJiL0Jqgzoig0kiiGzI440="}]},"_npmUser":{"name":"mbg9999","email":"miguel.belmonte99@gmail.com"},"directories":{},"maintainers":[{"name":"mbg9999","email":"miguel.belmonte99@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/autoskills_0.3.6_1781075712214_0.3674945179705402"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-10T07:15:12.043Z","0.3.6":"2026-06-10T07:15:12.442Z","modified":"2026-06-10T07:15:12.689Z"},"maintainers":[{"name":"mbg9999","email":"miguel.belmonte99@gmail.com"}],"description":"Auto-detect and install the best AI agent skills for your project","homepage":"https://github.com/Mbg999/autoskills-for-aidlc-factory","keywords":["agent","ai","auto","claude","cli","copilot","cursor","detect","skills"],"repository":{"type":"git","url":"git+https://github.com/Mbg999/autoskills-for-aidlc-factory.git"},"author":{"name":"Mbg999"},"bugs":{"url":"https://github.com/Mbg999/autoskills-for-aidlc-factory/issues"},"license":"CC-BY-NC-4.0","readme":"# autoskills\n\nAuto-detect and install the best AI agent skills for your project. One command, zero config.\n\n```bash\nnpx autoskills\n```\n\n`autoskills` scans your project, detects the technologies you use, and installs curated [AI agent skills](https://skills.sh) that make Cursor, Claude Code, and other AI coding assistants actually understand your stack.\n\n## Quick Start\n\nRun it in your project root:\n\n```bash\nnpx autoskills\n```\n\nThat's it. It will:\n\n1. **Scan** your `package.json`, config files, and project structure\n2. **Detect** every technology in your stack\n3. **Show** an interactive selector with the best skills for your project\n4. **Install** them in parallel with live progress\n5. **Generate `CLAUDE.md` automatically** when Claude Code is one of the target agents\n\n### Skip the prompt\n\n```bash\nnpx autoskills -y\n```\n\n### Preview without installing\n\n```bash\nnpx autoskills --dry-run\n```\n\n### Force specific technologies\n\nSkip auto-detection and install skills for the technologies you specify:\n\n```bash\nnpx autoskills --tech react --tech nextjs\nnpx autoskills --tech react,nextjs,tailwind\n```\n\n### Claude Code summary\n\nIf `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`.\n\n## Options\n\n| Flag              | Description                                           |\n| ----------------- | ----------------------------------------------------- |\n| `-y`, `--yes`     | Skip confirmation prompt, install all detected skills |\n| `--dry-run`       | Show detected skills without installing anything      |\n| `-v`, `--verbose` | Show install trace and error details                  |\n| `-t`, `--tech`    | Force specific technologies (skip auto-detect)        |\n| `-h`, `--help`    | Show help message                                     |\n\n## Supported Technologies\n\n`autoskills` detects **50+ technologies** from your `package.json`, lockfiles, Gradle files, and config files:\n\n### Frameworks & Libraries\n\n| Technology           | Detected from                                                                                                                                     |\n| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |\n| React                | `react`, `react-dom` packages                                                                                                                     |\n| Next.js              | `next` package or `next.config.*`                                                                                                                 |\n| Vue                  | `vue` package                                                                                                                                     |\n| Nuxt                 | `nuxt` package or `nuxt.config.*`                                                                                                                 |\n| Svelte               | `svelte`, `@sveltejs/kit` or `svelte.config.js`                                                                                                   |\n| Angular              | `@angular/core` or `angular.json`                                                                                                                 |\n| Astro                | `astro` package or `astro.config.*`                                                                                                               |\n| Expo                 | `expo` package                                                                                                                                    |\n| React Native         | `react-native` package                                                                                                                            |\n| Flutter              | `pubspec.yaml` file with `flutter:` key                                                                                                           |\n| Kotlin Multiplatform | Gradle with KMP plugin: `kotlin(\"multiplatform\")`, `org.jetbrains.kotlin.multiplatform`, or `kotlin-multiplatform` in `gradle/libs.versions.toml` |\n| Android              | Gradle with `com.android.application`, `com.android.library`, or `com.android.kotlin.multiplatform.library`                                       |\n| Remotion             | `remotion`, `@remotion/cli`                                                                                                                       |\n| GSAP                 | `gsap` package                                                                                                                                    |\n| Three.js             | `three`, `@react-three/fiber`, `@react-three/drei`                                                                                                |\n| Express              | `express` package                                                                                                                                 |\n| Hono                 | `hono` package                                                                                                                                    |\n| NestJS               | `@nestjs/core` package                                                                                                                            |\n| Spring Boot          | Gradle with `spring-boot-starter` or `org.springframework.boot`                                                                                   |\n| ASP.NET Core         | `.csproj` file with `Microsoft.NET.Sdk.Web`                                                                                                       |\n| Blazor               | `.csproj` with `Microsoft.NET.Sdk.BlazorWebAssembly` or `Microsoft.AspNetCore.Components`                                                         |\n| ASP.NET Minimal API  | `.csproj` with `Microsoft.AspNetCore.OpenApi` or `Swashbuckle.AspNetCore`                                                                         |\n\n### Styling & UI\n\n| Technology   | Detected from                                             |\n| ------------ | --------------------------------------------------------- |\n| Tailwind CSS | `tailwindcss`, `@tailwindcss/vite` or `tailwind.config.*` |\n| shadcn/ui    | `components.json`                                         |\n\n### Runtimes & Tooling\n\n| Technology | Detected from                                                |\n| ---------- | ------------------------------------------------------------ |\n| TypeScript | `typescript` package or `tsconfig.json`                      |\n| Node.js    | `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`, `.nvmrc` |\n| Bun        | `bun.lockb`, `bun.lock`, `bunfig.toml`                       |\n| Deno       | `deno.json`, `deno.jsonc`, `deno.lock`                       |\n| Dart       | `pubspec.yaml`                                               |\n| Go         | `go.mod`, `go.work`                                          |\n| Vite       | `vite` package or `vite.config.*`                            |\n| Turborepo  | `turbo` package or `turbo.json`                              |\n| Vitest     | `vitest` package or `vitest.config.*`                        |\n| oxlint     | `oxlint` package or `.oxlintrc.json`                         |\n| .NET       | `global.json`, `NuGet.Config`, `*.csproj`, `*.sln`           |\n| C#         | `*.csproj`, `*.sln`                                          |\n\n### Backend & Data\n\n| Technology      | Detected from                                            |\n| --------------- | -------------------------------------------------------- |\n| Supabase        | `@supabase/supabase-js`, `@supabase/ssr`                 |\n| Zod             | `zod` package                                            |\n| React Hook Form | `react-hook-form` package                                |\n| Neon Postgres   | `@neondatabase/serverless`                               |\n| Prisma          | `prisma`, `@prisma/client`                               |\n| Drizzle ORM     | `drizzle-orm`, `drizzle-kit`                             |\n| Stripe          | `stripe`, `@stripe/stripe-js`, `@stripe/react-stripe-js` |\n| Better Auth     | `better-auth` package                                    |\n\n### Authentication\n\n| Technology | Detected from                                                                                                         |\n| ---------- | --------------------------------------------------------------------------------------------------------------------- |\n| Clerk      | `@clerk/nextjs`, `@clerk/react`, `@clerk/expo`, `@clerk/astro`, `@clerk/remix`, `@clerk/vue`, or any `@clerk/*` scope |\n\n### Cloud & Deploy\n\n| Technology        | Detected from                                        |\n| ----------------- | ---------------------------------------------------- |\n| Vercel            | `vercel.json`, `.vercel/`, `@astrojs/vercel`         |\n| Cloudflare        | `wrangler`, `wrangler.toml`, `@astrojs/cloudflare`   |\n| Cloudflare Agents | `agents` package                                     |\n| Cloudflare AI     | `@cloudflare/ai` or AI binding in `wrangler.json`    |\n| Durable Objects   | `durable_objects` in `wrangler.json`/`wrangler.toml` |\n| Azure             | `@azure/*` packages                                  |\n| AWS               | `@aws-sdk/*`, `aws-cdk*` packages                    |\n\n### AI\n\n| Technology    | Detected from                                                 |\n| ------------- | ------------------------------------------------------------- |\n| Vercel AI SDK | `ai`, `@ai-sdk/openai`, `@ai-sdk/anthropic`, `@ai-sdk/google` |\n| ElevenLabs    | `elevenlabs` package                                          |\n\n### Other\n\n| Technology | Detected from                                                                               |\n| ---------- | ------------------------------------------------------------------------------------------- |\n| Playwright | `@playwright/test`, `playwright` or `playwright.config.*`                                   |\n| SwiftUI    | `Package.swift`                                                                             |\n| WordPress  | `wp-config.php`, `@wordpress/*`, `composer.json` with wpackagist, theme `style.css`         |\n| Tauri      | `@tauri-apps/api`, `@tauri-apps/cli` or `src-tauri/tauri.conf.json`                         |\n| Electron   | `electron` package, `electron-builder.yml`, `forge.config.js`, or `electron-vite.config.ts` |\n\n### Web Frontend Detection\n\nEven 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.\n\n## Combo Detection\n\nWhen multiple technologies are used together, `autoskills` detects **technology combos** and adds specialized skills for the combination:\n\n- **Next.js + Supabase** — Supabase Postgres best practices for Next.js\n- **Next.js + Vercel AI SDK** — AI SDK patterns with Next.js\n- **Next.js + Playwright** — E2E testing best practices for Next.js\n- **React + shadcn/ui** — shadcn component patterns with React\n- **Tailwind CSS + shadcn/ui** — Tailwind v4 + shadcn integration\n- **Expo + Tailwind CSS** — Tailwind setup for Expo\n- **React Native + Expo** — Native UI patterns\n- **React Hook Form + Zod** — Form validation patterns with Zod schemas\n- **GSAP + React** — GSAP animation patterns in React\n- **Cloudflare + Vite** — Vinext migration guide\n- **Node.js + Express** — Express server patterns\n\n## How It Works\n\n`autoskills` uses [skills.sh](https://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.\n\nThe detection runs entirely locally with zero network requests until installation begins.\n\nIt also performs a heuristic recursive scan for nested package manifests (e.g. `packages/*/package.json`, `apps/*/Cargo.toml`) even when no workspace configuration is present, so monorepos and hybrid repos are covered out of the box.\n\n## Requirements\n\n- Node.js >= 22.0.0\n\n## License\n\nCC-BY-NC-4.0 — Created by [@midudev](https://github.com/midudev)\n","readmeFilename":"README.md","_rev":"1-ddb5238b033c89ef0debb4258de0adf9"}