Skip to content
Skillpedia
Prompts & LLMs280k · #262

prompt-optimizer

Has your agent analyze and improve the prompts you write. It suggests how to add information or change the wording so the AI model understands better and gives the desired answer.

What it does

This AI agent helps you improve your requests (prompts) for other AIs. It analyzes what you want to ask, suggests improvements, and indicates which AI tools might be most useful for your task.

When to use it

  • ✓When you want the AI to improve a request you've written.
  • ✓When you're unsure how to ask the AI for something.
  • ✓When you want to know which AI tools are best for a specific task.

Example of what to ask your AI

“Optimize this prompt: 'Write code for a simple website'.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/affaan-m/ECC/blob/main/skills/prompt-optimizer/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/affaan-m/ECC/blob/main/skills/prompt-optimizer/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

It first understands your goal and project context. Then, it suggests a clearer prompt and points to the most suitable AI tools to accomplish the task.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add affaan-m/ECC --skill prompt-optimizer

Or download just the file:

curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/prompt-optimizer/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Prompt Optimizer

Analyze a draft prompt, critique it, match it to ECC ecosystem components, and output a complete optimized prompt the user can paste and run.

When to Use

  • User says "optimize this prompt", "improve my prompt", "rewrite this prompt"
  • User says "help me write a better prompt for..."
  • User says "what's the best way to ask Claude Code to..."
  • User says "优化prompt", "改进prompt", "怎么写prompt", "帮我优化这个指令"
  • User pastes a draft prompt and asks for feedback or enhancement
  • User says "I don't know how to prompt for this"
  • User says "how should I use ECC for..."
  • User explicitly invokes /prompt-optimize

Do Not Use When

  • User wants the task done directly (just execute it)
  • User says "优化代码", "优化性能", "optimize this code", "optimize performance" — these are refactoring tasks, not prompt optimization
  • User is asking about ECC configuration (use configure-ecc instead)
  • User wants a skill inventory (use skill-stocktake instead)
  • User says "just do it" or "直接做"

How It Works

Advisory only — do not execute the user's task.

Do NOT write code, create files, run commands, or take any implementation action. Your ONLY output is an analysis plus an optimized prompt.

If the user says "just do it", "直接做", or "don't optimize, just execute", do not switch into implementation mode inside this skill. Tell the user this skill only produces optimized prompts, and instruct them to make a normal task request if they want execution instead.

Run this 6-phase pipeline sequentially. Present results using the Output Format below.

Analysis Pipeline

Phase 0: Project Detection

Before analyzing the prompt, detect the current project context:

  1. Check if a CLAUDE.md exists in the working directory — read it for project conventions
  2. Detect tech stack from project files:
    • package.json → Node.js / TypeScript / React / Next.js
    • go.mod → Go
    • pyproject.toml / requirements.txt → Python
    • Cargo.toml → Rust
    • build.gradle / pom.xml → Java / Kotlin (then check for quarkus in build file → Quarkus, or spring-boot → Spring Boot)
    • Package.swift → Swift
    • Gemfile → Ruby
    • composer.json → PHP
    • *.csproj / *.sln → .NET
    • Makefile / CMakeLists.txt → C / C++
    • cpanfile / Makefile.PL → Perl
  3. Note detected tech stack for use in Phase 3 and Phase 4

If no project files are found (e.g., the prompt is abstract or for a new project), skip detection and flag "tech stack unknown" in Phase 4.

Phase 1: Intent Detection

Classify the user's task into one or more categories:

Category Signal Words Example
New Feature build, create, add, implement, 创建, 实现, 添加 "Build a login page"
Bug Fix fix, broken, not working, error, 修复, 报错 "Fix the auth flow"
Refactor refactor, clean up, restructure, 重构, 整理 "Refactor the API layer"
Research how to, what is, explore, investigate, 怎么, 如何 "How to add SSO"
Testing test, coverage, verify, 测试, 覆盖率 "Add tests for the cart"
Review review, audit, check, 审查, 检查 "Review my PR"
Documentation document, update docs, 文档 "Update the API docs"
Infrastructure deploy, CI, docker, database, 部署, 数据库 "Set up CI/CD pipeline"
Design design, architecture, plan, 设计, 架构 "Design the data model"

Phase 2: Scope Assessment

If Phase 0 detected a project, use codebase size as a signal. Otherwise, estimate from the prompt description alone and mark the estimate as uncertain.

Scope Heuristic Orchestration
TRIVIAL Single file, < 50 lines Direct execution
LOW Single component or module Single command or skill
MEDIUM Multiple components, same domain Command chain + /verify
HIGH Cross-domain, 5+ files /plan first, then phased execution
EPIC Multi-session, multi-PR, architectural shift Use blueprint skill for multi-session plan

Phase 3: ECC Component Matching

Map intent + scope + tech stack (from Phase 0) to specific ECC components.

By Intent Type

Intent Commands Skills Agents
New Feature /plan, /tdd, /code-review, /verify tdd-workflow, verification-loop planner, tdd-guide, code-reviewer
Bug Fix /tdd, /build-fix, /verify tdd-workflow tdd-guide, build-error-resolver

…

FAQ

What is a 'prompt'?

A prompt is the instruction or question you give to an artificial intelligence.

Will this agent do the task for me?

No, it only optimizes your request. You'll need to use the optimized prompt with another AI tool to perform the task.

What are 'ECC components'?

These are the different tools and agents within the AI system that can help accomplish tasks.

Details

Original description by the author

Analyze draft prompts, detect intent and missing context, match ECC commands, skills, and agents, and output a ready-to-paste optimized prompt with diagnosis and rationale — advisory only, never executes the task. Use when the user says 'optimize prompt', 'improve my prompt', 'rewrite this prompt', 'help me prompt', 优化prompt, 改进prompt, 怎么写prompt, or 帮我优化这个指令; not for requests to optimize code or p

repo: affaan-m/ECC

Popularity

GitHub stars
280k
Ranking position
#262
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills