# autoskills
**One command. Your entire AI skill stack. Installed.**
[autoskills.sh](https://autoskills.sh)
Scans your project, detects your tech stack, and installs curated AI agent skills automatically.
```bash
npx autoskills
```
## How it works
1. Run `npx autoskills` in your project root
2. Your `package.json`, Gradle files, and config files are scanned to detect technologies
3. The best matching AI agent skills are selected from the audited autoskills registry
4. Only the selected skill files are downloaded from the registry and verified before writing them locally
That's it. No config needed.
## Security model
`autoskills` does not install directly from random upstream repositories at runtime.
Skills are synced by maintainers into the repository-local autoskills registry, reviewed by AI for prompt-injection and supply-chain attacks (a fast model triages every change and a stronger one decides on anything suspicious), and recorded with SHA-256 hashes in a manifest. Skills that are safe but worth a heads-up are shown with a security warning before you install them. When you run `autoskills`, the CLI downloads only the skills your project needs from that curated registry, verifies every file against the manifest, and writes a `skills-lock.json` entry with the installed source and bundle hash.
This keeps the package small while avoiding live downloads from third-party skill sources during installation.
## Options
```
-y, --yes Skip confirmation prompt
--dry-run Show what would be installed without installing
--clear-cache Clear the downloaded skills cache
-a, --agent Install for specific IDEs only (e.g. cursor claude-code)
-v, --verbose Show install trace and error details
-h, --help Show help message
```
Run `npx autoskills ui` to browse the skills installed in your project in a local web desk.
## Supported Technologies
Built to work across modern frontend, backend, mobile, cloud, and media stacks.
- **Frameworks & UI:** React, Next.js, Vue, Nuxt, Svelte, Angular, Astro, Tailwind CSS, shadcn/ui, GSAP, Three.js
- **Languages & Runtimes:** TypeScript, Node.js, Go, Bun, Dart
- **Backend & APIs:** Express, Hono, NestJS, Spring Boot
- **Mobile & Desktop:** Expo, React Native, Flutter, SwiftUI, Android, Kotlin Multiplatform, Tauri, Electron
- **Data & Storage:** Supabase, Neon, Prisma, Drizzle ORM, Zod, React Hook Form
- **Auth & Billing:** Better Auth, Clerk, Stripe
- **Testing:** Vitest, Playwright
- **Cloud & Infrastructure:** Vercel, Vercel AI SDK, Cloudflare, Durable Objects, Cloudflare Agents, Cloudflare AI, AWS, Azure, Terraform
- **Tooling:** Turborepo, Vite, oxlint
- **Media & AI:** Remotion, ElevenLabs
## Requirements
Node.js >= 22.6
## License
[CC BY-NC 4.0](./LICENSE) — [midudev](https://midu.dev)
---
### Overview (`packages/autoskills/README.md`)
# autoskills
Auto-detect and install the best AI agent skills for your project. One command, zero config.
```bash
npx autoskills
```
`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.
## Quick Start
Run it in your project root:
```bash
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
```bash
npx autoskills -y
```
### Preview without installing
```bash
npx autoskills --dry-run
```
### Browse installed skills
```bash
npx autoskills ui
```
Opens a local desk (bound to `127.0.0.1`) to browse the skills installed in the current project.
### 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 |
| `--clear-cache` | Clear the downloaded skills cache |
| `-a`, `--agent` | Install for specific IDEs only (e.g. `cursor claude-code`) |
| `-v`, `--verbose` | Show install trace and error details |
| `-h`, `--help` | Show help message |
`autoskills ui` also accepts `--port