npm package: @shabadpreetjaswal/projectkit
Description: Claude Code agent for full web project setup automation — installs skills, plugins, and dependencies in one command
Latest version: 2.1.0

# Project Launcher

A Claude Code agent that builds complete web projects — from first question to working site. Install once, then just describe what you want.

## Quick Start

```bash
# 1. Install everything (one time)
npx @shabadpreetjaswal/projectkit install

# 2. Open Claude Code in your projects folder
cd ~/Desktop/projecten
claude

# 3. Ask Claude to build a project
> "Build a website for a barber shop in Amsterdam"
```

That's it. The installer handles skills, plugins, and configuration automatically.

## What the installer does

The `install` command configures everything in one step:

- **13 project-launcher skills** to `~/.claude/skills/`
- **6 dependency skills** (astro, seo, tailwind-v4, frontend-design-system, etc.)
- **Superpowers plugin** activated in `settings.json`
- **Trigger helper** as fallback so Claude always responds to project requests
- **Post-install verification** that everything is correctly installed

## What the agent does

- Asks smart questions about your project (or parses a provided briefing)
- Scrapes your existing website for content if you have one
- Writes a complete implementation plan for your approval
- Builds the entire project: scaffold, design, database, pages, API, SEO, deployment
- Checks content with you — never invents personal information
- Validates everything (build, accessibility, SEO) and starts the dev server
- Generates a content checklist for any placeholders you need to fill in
- Gives you an interactive post-build guide with next steps

## The 13 Skills

| Skill | Phase | What it does |
|---|---|---|
| `trigger-helper` | Trigger | Catches trigger phrases as fallback |
| `doctor` | Diagnostics | Diagnoses installation issues from within Claude |
| `project-intake` | Intake | Ask questions, parse briefings, generate project spec |
| `project-planner` | Planning | Write exhaustive implementation plan |
| `project-orchestrator` | Execution | Execute plan phase by phase |
| `project-designer` | Design | Visual direction, color palette, design tokens |
| `astro-scaffold` | Scaffold | Set up Astro project + dependencies |
| `nextjs-scaffold` | Scaffold | Set up Next.js App Router project |
| `db-setup` | Database | Neon PostgreSQL via MCP + Drizzle ORM |
| `page-generator` | Pages | Layouts, components, pages, API routes |
| `devops-config` | DevOps | Deployment config, env vars, git init, GitHub repo |
| `claude-md-writer` | Docs | Generate CLAUDE.md from actual built project |
| `qa-validation` | QA | Build test, accessibility audit, SEO check, content checklist |

## How it works

```
You: "Build a website for a barber shop in Amsterdam"
  |
  v
[project-intake]     Asks questions, generates spec
  |                  "Approve?" -> yes
  v
[project-planner]    Writes full plan with framework explanation
  |                  "Approve?" -> yes
  v
[project-orchestrator] Executes the plan:
  |
  |-- [astro-scaffold]     npm create astro, dependencies
  |-- [project-designer]   Colors, fonts, design tokens
  |-- [db-setup]           Neon database + Drizzle schema
  |-- [page-generator]     All pages and components
  |                        -> Live preview starts here
  |                        -> Content review checkpoint
  |-- [devops-config]      .env, deployment, git, GitHub repo
  |                        -> Service onboarding guides
  |-- [claude-md-writer]   CLAUDE.md documentation
  |-- [qa-validation]      Build check, a11y, SEO, content checklist
  |
  v
Working project + deployment walkthrough + interactive "what next?" menu
```

## Language Support

The agent detects your language from the first message and uses it consistently throughout the entire pipeline. Works in Dutch and English.

## Requirements

- **Node.js 18+** and **npm**
- **Claude Code** installed (`npm install -g @anthropic-ai/claude-code`)
- **Neon MCP server** (optional, for database projects) — [setup guide](https://neon.tech/docs/ai/neon-mcp-server)

## CLI Commands

```bash
npx @shabadpreetjaswal/projectkit              # Install (default)
npx @shabadpreetjaswal/projectkit install      # Install skills + plugins
npx @shabadpreetjaswal/projectkit update       # Update to latest version
npx @shabadpreetjaswal/projectkit list         # Show installed skills
npx @shabadpreetjaswal/projectkit doctor       # Diagnose issues
npx @shabadpreetjaswal/projectkit uninstall    # Remove everything
npx @shabadpreetjaswal/projectkit help         # Show all commands
```

## Supported project types

- Business website (barber, restaurant, construction, etc.)
- E-commerce / webshop
- SaaS / web app
- Portfolio / personal
- Professional services
- One-pager

## Tech Stack

The agent chooses automatically based on your project:

- **Framework:** Astro or Next.js (with explanation why)
- **Styling:** Tailwind CSS v4
- **Database:** Neon PostgreSQL + Drizzle ORM
- **Email:** Resend
- **Deployment:** Cloudflare Pages or Vercel
- **TypeScript:** Strict mode

## Troubleshooting

```bash
npx @shabadpreetjaswal/projectkit doctor
```

Or inside Claude Code, say "my project launcher isn't working" and the doctor skill will diagnose the issue.

## License

MIT