prompt-improver
Prompt Improver refines code-related prompts by evaluating task clarity, investigation depth, verification steps, and scope control. It applies transformation rules to strengthen prompts for implementation, debugging, refactoring, code review, and testing tasks. The skill ensures prompts follow investigation-first principles and include appropriate verification checks before execution.
Prompt Improver optimizes code-related prompts by applying investigation-first thinking and verification best practices.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-21
Prompt Improver optimizes code-related prompts by applying investigation-first thinking and verification best practices. Prompt Improver refines code-related prompts by evaluating task clarity, investigation depth, verification steps, and scope control. It applies transformation rules to strengthen prompts for implementation, debugging, refactoring, code review, and testing tasks. The skill ensures prompts follow investigation-first principles and include appropriate verification checks before execution.
Use it when
- Prompt Improver optimizes coding prompts through systematic evaluation of task clarity, scope control, and investigation depth.
- Yes.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
existential-birds/beagle/prompt-improver · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I improve prompts for testing with prompt-improver?
Prompt Improver refines testing prompts by evaluating task clarity, investigation depth, and verification steps. It applies transformation rules to strengthen your prompts, ensuring they follow investigation-first principles and include appropriate verification checks before execution. This approach helps AI systems understand test requirements more precisely and catch edge cases earlier.
What makes prompt-improver optimize prompts for coding tasks?
Prompt Improver optimizes coding prompts through systematic evaluation of task clarity, scope control, and investigation depth. It transforms prompts to strengthen implementation, debugging, refactoring, and code review tasks by adding verification steps and ensuring investigation-first principles are applied. The skill helps developers write clearer, more actionable prompts that yield better AI-assisted results.
Can prompt-improver enhance prompts for code review?
Yes. Prompt Improver enhances code review prompts by refining task clarity, adding verification steps, and controlling scope. It applies transformation rules that strengthen prompts for review tasks, ensuring they follow investigation-first principles. This helps reviewers ask AI systems more specific questions about code quality, maintainability, and potential issues.
What prompt engineering best practices does prompt-improver teach?
Prompt Improver teaches investigation-first principles, scope control, and verification-step inclusion for software development. It demonstrates how to evaluate task clarity and depth before execution, apply transformation rules to strengthen prompts, and structure prompts for debugging, refactoring, testing, and implementation tasks. These practices help developers write more effective AI prompts consistently.
How does prompt-improver add verification to existing code prompts?
Prompt Improver adds verification and scope control to existing prompts by evaluating current task clarity and investigation depth, then applying targeted transformation rules. It strengthens prompts by inserting verification checks before execution and clarifying scope boundaries. This ensures AI systems validate assumptions and stay focused on the intended task.
What is prompt-improver licensed under?
Prompt Improver is licensed under Apache-2.0, allowing free use, modification, and distribution with proper attribution. This open license supports collaborative development and integration into other software development tools and workflows.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Prompt Improver
Optimize code-related prompts for clarity, investigation-first thinking, and verification.
Input
$ARGUMENTS
Step 1: Analyze the Prompt
Evaluate the input prompt across these dimensions:
| Dimension | What to check |
|---|---|
| Task Clarity | Is the task type clear? (implement, fix, refactor, review, test) Are boundaries defined? |
| Investigation | Does it specify reading/understanding before acting? |
| Verification | Are there appropriate checks? (run tests, build, lint) |
| Context Anchoring | Does it reference specific files, functions, or patterns? |
| Action Specificity | Is the desired outcome explicit? Quality expectations stated? |
| Scope Control | Is it appropriately scoped? Clear stopping points? |
Identify which dimensions are weak or missing in the input prompt.
Gates (sequenced)
Complete in order; do not skip steps.
- **Audit gate (end of Step
(truncated - see the full file via the links below)
File tree — 1 file
plugins/beagle-core/skills/prompt-improver/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Optimize code-related prompts for clarity and investigation-first approach”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill audits URLSession implementations across iOS and macOS projects, checking async/await adoption, proper HTTP status validation, memory lifecycle management, and secure request construction. It validates response handling, resource cleanup, session configuration, and background transfer patterns against a structured checklist. Use it when reviewing code that touches URLSession, URLRequest, URLCache, or URLError APIs.
This skill systematically audits Swift source files for concurrency hazards, including unsafe async/await patterns, actor reentrancy, Sendable conformance gaps, and memory leaks from retain cycles. It establishes Swift language version context upfront, reads full enclosing symbols rather than diffs alone, and applies targeted checklists for error handling, force unwraps, and closure capture semantics before reporting findings.
This skill scans conversations, session transcripts, and design discussions to isolate architectural decisions—capturing problem statements, chosen options, alternatives considered, and decision drivers. It recognizes explicit `[ADR]` tags alongside implicit choice patterns and trade-off debates, then rates each decision's confidence level. Output feeds directly into ADR writing tools rather than generating documents itself.
Better Icons lets you search and fetch SVG icons from over 200 icon libraries through Iconify. Use the CLI to find icons by query, retrieve them by ID, or batch download results—with options to customize color and size. Also works as an MCP server for AI agents.
This skill acts as a prompt coach, evaluating every instruction you send to an AI system across seven key dimensions: clarity, specificity, context, structure, examples, constraints, and completeness. It scores each area, identifies gaps, and delivers a rewritten version designed to produce better results on the first try. Works with any prompt type—code generation, writing, analysis, or creative tasks.
This skill systematically audits Python code across five key dimensions: PEP8 compliance, type annotation completeness, async/await correctness, exception handling rigor, and frequent pitfalls like mutable defaults. It provides a checklist-driven review workflow with reference guides for each category and context-sensitive rules to avoid false positives.
More skills codspeed-optimize (Apache-2.0)