⚡ agentcraftx

Auto-detect your tech stack and install the best AI agent skills. Zero config. One command.

by devmubs

npx agentcraftx

What it does

agentcraftx scans your project, detects every technology you're using, and installs curated AI agent skill files into your IDE's agent directory — so Claude Code, Cursor, Windsurf, and other AI IDEs actually understand your stack.

No config. No accounts. No external services. Works offline with embedded fallbacks.

Quick Start

Run in your project root:

npx agentcraftx

That's it. It will:

1. Scan package.json, composer.json, go.mod, Cargo.toml, config files, and more
2. Detect every technology in your stack
3. Show an interactive skill selector
4. Fetch and write skill files directly to your agent directory

Options

| Flag | Description | |---|---| | -y, --yes | Skip confirmation, install all detected skills | | --dry-run | Preview what would be installed without installing | | -v, --verbose | Show error details on failure | | -a, --agent | Install for specific IDE(s) only (see below) | | -d, --dir | Run against a specific directory | | list / ls | List all installed skills in the project | | -V, --version | Print version | | -h, --help | Show help |

Examples

# Auto-detect and install everything
npx agentcraftx

# Skip prompt, install all
npx agentcraftx -y

# Preview without installing
npx agentcraftx --dry-run

# Only install for Cursor
npx agentcraftx -y -a cursor

# Install for both Claude Code and Cursor
npx agentcraftx -y -a claude-code cursor

# Run in a different directory
npx agentcraftx --dir ./packages/web

# List installed skills
npx agentcraftx list

Supported IDEs

| IDE | Agent ID | Skills location | |---|---|---| | Claude Code | claude-code | .claude/skills/ | | Cursor | cursor | .cursor/rules/ | | Windsurf | windsurf | .windsurf/rules/ | | Cline | cline | .cline/skills/ | | GitHub Copilot | github-copilot | .github/instructions/ | | Universal | universal | .agent-skills/ |

When no --agent flag is given, agentcraftx auto-detects installed IDEs from your home directory and installs to all of them. The universal location is always included.

Supported Technologies

agentcraftx detects 80+ technologies across every major ecosystem:

JavaScript / TypeScript

React · Next.js · Vue.js · Nuxt · Svelte / SvelteKit · Angular · Astro · Solid.js · Remix · Tailwind CSS · shadcn/ui · TypeScript · Vite · Vitest · Playwright · Jest · Bun · Deno · Node.js

Backend / API

Express · Fastify · NestJS · Hono · tRPC · GraphQL

Database / ORM

Prisma · Drizzle ORM · Supabase · Neon Postgres · Mongoose / MongoDB · Redis

Auth & Payments

Clerk · NextAuth / Auth.js · Better Auth · Stripe

State Management

Zustand · Redux Toolkit

Validation

Zod

AI / ML

Vercel AI SDK · LangChain · OpenAI SDK · Anthropic SDK

Python

Django · FastAPI · Flask · Celery

PHP

Laravel · Symfony · WordPress · WooCommerce

Go

Go · Gin · Echo

Rust

Rust · Axum

Mobile

Expo · React Native

DevOps / Cloud

Docker · Docker Compose · GitHub Actions · Vercel · Cloudflare Workers

Monorepo / Build

Turborepo · Nx

Desktop

Tauri

Styling

Styled Components

Combo Detection

When multiple technologies are used together, agentcraftx detects the combination and adds specialized skills:

| Combo | Extra Skills | |---|---| | Next.js + Supabase | Supabase SSR patterns for App Router | | Next.js + Prisma | Singleton client, Server Actions | | Next.js + Vercel AI SDK | Streaming with App Router | | Next.js + Clerk | Middleware auth patterns | | Next.js + Stripe | Webhook route handler patterns | | React + shadcn/ui | shadcn component patterns | | Tailwind + shadcn/ui | Tailwind v4 + shadcn integration | | WordPress + WooCommerce | WC hooks and order patterns |

How it works

All detection runs locally — no network requests until installation begins.

Detection checks:

• package.json (dependencies, devDependencies, peerDependencies)
• composer.json (PHP/WordPress)
• go.mod (Go modules)
• Cargo.toml (Rust crates)
• requirements.txt / pyproject.toml (Python)
• Config files (tailwind.config.ts, next.config.mjs, docker-compose.yml, etc.)
• File content patterns (Gradle files, wrangler.toml, etc.)
• Workspace/monorepo resolution (npm, pnpm, yarn)

Skills are fetched from GitHub's raw content CDN. Every skill also has embedded fallback content that works completely offline.

Why agentcraftx vs alternatives

| | agentcraftx | autoskills | |---|---|---| | Zero dependencies | ✅ Pure Node.js built-ins | ❌ Requires skills.sh CLI | | Works offline | ✅ Embedded skill content | ❌ Requires network | | Node.js version | ✅ Node >= 18 | ❌ Node >= 22 only | | Ecosystems | ✅ Node, Python, PHP, Go, Rust | ⚠️ Node-only | | WordPress / WooCommerce | ✅ 6 detection signals, 5 skills | ⚠️ Limited | | Windsurf support | ✅ | ❌ | | list command | ✅ | ❌ | | --dir flag | ✅ | ❌ | | --version flag | ✅ | ❌ |

Requirements

• Node.js >= 18.0.0
• No other runtime dependencies

License

MIT — devmubs

Contributing

PRs welcome! To add a new technology:

1. Add a new entry to src/skills-map.mjs in SKILLS_MAP
2. Define detect rules (packages, configFiles, fileContent, etc.)
3. Add skills array with name, source, and description
4. Add combo entries to COMBO_MAP if relevant

Skills are markdown files. The source can be:

• A GitHub shorthand: "owner/repo/skill-path"
• A full URL: "https://..."
• Embedded content: { embed: "# My Skill\n\n..." } (always works offline)

Built with ❤️ by devmubs