prompt-optimizer

Analyze draft prompts and generate optimized prompts matched to ECC commands, skills, and agents.

2|Updated May 30, 2026
One-click install
npx skills add https://github.com/virahitvin8/crafty-gis --skill prompt-optimizer-virahitvin8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-optimizer
Source: https://github.com/virahitvin8/crafty-gis/tree/main/GIT_STAR/.agent/skills/prompt-optimizer
Command: npx skills add https://github.com/virahitvin8/crafty-gis --skill prompt-optimizer-virahitvin8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Vague or incomplete prompts lead to poor AI coding results. This Skill diagnoses weaknesses in a draft prompt, detects project context, and produces a complete, ready-to-paste optimized prompt with the right workflow commands, acceptance criteria, and scope boundaries. ## Core Features & Use Cases - Six-Phase Analysis Pipeline: Detects project tech stack, classifies intent (feature, bug fix, refactor, research, etc.), assesses scope from TRIVIAL to EPIC, and identifies missing context. - ECC Component Matching: Maps intent and tech stack to specific commands (/plan, /tdd, /verify), skills (tdd-workflow, blueprint), agents (code-reviewer), and model recommendations. - Bilingual Trigger Support: Responds to both English and Chinese prompt-optimization requests, with explicit guardrails against triggering on code/performance optimization requests. - Use Case: A user pastes "帮我写一个用户登录页面". The Skill detects a Next.js + TypeScript project, then outputs a full optimized prompt including security requirements, TDD workflow steps, acceptance criteria, and explicit out-of-scope items. ## Quick Start Ask the assistant to optimize or rewrite your draft prompt, for example by saying "optimize this prompt for adding a user profile API endpoint".

Frequently Asked Questions about prompt-optimizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize a prompt for Claude Code?

Paste your draft prompt and ask to optimize it. The Skill runs a six-phase pipeline that detects your project tech stack, classifies intent, assesses scope, and outputs a complete rewritten prompt with workflow commands, acceptance criteria, and scope boundaries.

What is the difference between prompt optimization and code optimization triggers?

Prompt optimization rewrites your instructions to an AI assistant, while code optimization refactors source code. This Skill explicitly does not trigger on phrases like "optimize this code" or "优化性能", which are treated as refactoring tasks instead.

Does the prompt optimizer execute the task it optimizes?

No, it is advisory only and never writes code, creates files, or runs commands. Its only output is an analysis plus an optimized prompt you can paste into a new request. If you want execution, make a normal task request instead.

How does the skill detect my project tech stack?

It scans for marker files in the working directory: package.json for Node/TypeScript, go.mod for Go, pyproject.toml for Python, Cargo.toml for Rust, build.gradle for Java, and similar files for Swift, Ruby, PHP, .NET, and C/C++.

When should I use the blueprint skill instead of a single optimized prompt?

Use blueprint for EPIC-scope work such as monolith-to-microservices migrations that span multiple sessions and PRs. The optimizer recommends blueprint when scope assessment shows multi-session, architectural-level changes requiring phased execution.

Can the prompt optimizer handle Chinese prompts?

Yes, it triggers on Chinese phrases like "优化prompt", "改进prompt", and "帮我优化这个指令", and responds in the same language as the user's input, including fully Chinese optimized prompt output.