A Claude Code plugin agent that intercepts vague prompts before execution. Detects your stack, asks targeted questions, and forges a structured prompt for Claude Code. No re-prompts. Zero wasted credits.
Works for every major stack: Next.js, React Native, Expo, Supabase, Prisma, FastAPI, Chrome MV3, Tailwind, shadcn, Clerk, Vercel AI SDK, LangChain, Drizzle, Cloudflare Workers, and 30+ more. Each stack has its own pitfall rules, scope anchors, and stop conditions baked in - so the forged prompt is never generic and common.
🚨 Demo
🔗 By the Same Creator
| Tool | What it does | Stars |
|---|
| prompt-master | A free Claude.ai skill that writes the accurate prompts for ANY AI tool. | 4,000+ ⭐ |
🚀 Installation
Requirements: Claude Code v2.0+ · Python 3.8+
#1 - Marketplace (Recommended)
Step 1 - Add the marketplace via terminal
claude plugin marketplace add nidhinjs/prompt-mini
Step 2 - Install via terminal
claude plugin install prompt-mini@nidhinjs-marketplace
Step 3 - Run this script
Mac / Linux:
python3 ~/.claude/plugins/cache/nidhinjs-marketplace/prompt-mini/0.1.0/setup.py
Windows:
python "$env:USERPROFILE\.claude\plugins\cache\nidhinjs-marketplace\prompt-mini\0.1.0\setup.py"
Step 4 - Restart Claude Code
In Claude Code → Verify with /prompt-mini → you should see prompt-mini listed.
Running the script is required due to a known Claude Code bug where plugin hooks don't register automatically.
#2 - Local Install (Contributors)
Step 1 - Clone
git clone https://github.com/nidhinjs/prompt-mini.git
Step 2 - Create a parent folder
Mac / Linux:
cd ..
mkdir prompt-mini-dev && cd prompt-mini-dev
mkdir .claude-plugin
echo '{"name":"local-dev","owner":{"name":"nidhinjs"},"plugins":[{"name":"prompt-mini","source":"./prompt-mini"}]}' > .claude-plugin/marketplace.json
mv ../prompt-mini ./prompt-mini
Windows:
cd ..
mkdir prompt-mini-dev; cd prompt-mini-dev; mkdir .claude-plugin
[System.IO.File]::WriteAllText(".claude-plugin\marketplace.json", '{"name":"local-dev","owner":{"name":"nidhinjs"},"plugins":[{"name":"prompt-mini","source":"./prompt-mini"}]}')
mv ..\prompt-mini .\prompt-mini
Step 3 - Register and install
claude plugin marketplace add /absolute/path/to/prompt-mini-dev
claude plugin install prompt-mini@local-dev
Step 4 - Run setup
python prompt-mini/setup.py
Step 5 - Restart Claude Code
🎯 How It Works
Every prompt you type gets evaluated by a lightweight Python hook:
Clear prompt? → Passes through instantly. Zero questions.
Vague or framework-specific prompt? → Hook intercepts. Skill fires. Asks 2-6 targeted questions. Assembles a structured prompt and executes it.
You type a prompt
↓
Hook evaluates (~189 tokens)
↓
Clear? ──────────────────→ Pass through instantly
│
Vague?
↓
Scans project files (package.json, CLAUDE.md, imports)
Detects your stack automatically
Asks ≤5 clarifying questions
Assembles structured 6-block forged prompt
↓
Claude Code executes the forged prompt
⌨️ Bypass
Add * at the start of any prompt to skip prompt-mini entirely:
* fix the login bug
Other auto-bypasses: /slash-commands and #memory-commands pass through unchanged.
🛠️ Supported Stacks
Framework specific routing, scope anchors, and stop conditions for every major stack.
Web Frameworks (11)
| Stack | What prompt-mini prevents |
|---|
| Next.js App Router | Adds "use client" everywhere, mixes App/Pages Router, forgets "use server" on actions |
| Next.js Pages Router | Uses server actions (App Router only), wrong data fetching pattern |
| Remix | Confuses loaders with server actions, misses nested routing |
| SvelteKit | Writes React patterns in Svelte files, wrong file conventions |
| Astro | Adds React hooks to .astro files, treats it like a SPA |
| Vite + React | Attempts server actions, forgets all fetching is client-side |
| Vite + Vue 3 | Mixes Options API and Composition API |
| Nuxt 3 | Mixes Nuxt 2 patterns, wrong composables structure |
| Qwik City | Treats it like React, misses resumability patterns |
| T3 Stack | Creates REST routes instead of tRPC procedures, misses root router |
| Astro | Adds hooks to .astro files, forgets island component boundaries |
Mobile (5)