critical-prompt-refiner

Analyze user prompts to reveal assumptions and propose clearer, actionable alternatives.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/JOSETRA44/SKILLS --skill critical-prompt-refiner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: critical-prompt-refiner
Source: https://github.com/JOSETRA44/SKILLS/tree/main/critical-prompt-refiner
Command: npx skills add https://github.com/JOSETRA44/SKILLS --skill critical-prompt-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill empowers Gemini CLI to think critically about user requests, refine prompts for better results, and propose superior solutions rather than blindly following instructions.

Core Features & Use Cases

  • Analyze the request to identify the user's core goal and any hidden assumptions.
  • Challenge assumptions and surface gaps that could lead to suboptimal outcomes.
  • Refine prompts to increase clarity, specificity, and safety, while preserving intent.
  • Explore alternative architectures and patterns using mental models from references/critical-thinking.md.

Quick Start

Submit a user plan and ask Gemini to critically analyze, refine the prompt, and propose better solutions.

Frequently Asked Questions about critical-prompt-refiner

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

FAQPage Schema
How do I critically analyze a prompt to find hidden assumptions?

To critically analyze a prompt, the skill lists underlying assumptions, challenges gaps, and explores alternative solutions using structured reasoning. This reveals vague requirements and proposes clearer, more actionable prompts while preserving the original intent.

What is the best way to refine vague architecture and feature requests?

The best way to refine vague architecture requests is to apply structured reasoning steps that evaluate evidence-based trade-offs. This process deconstructs suboptimal prompts into specific, actionable plans by challenging assumptions and exploring alternative patterns.

How do I evaluate alternative solutions when reviewing a plan?

You evaluate alternative solutions by applying critical thinking mental models to explore different architectures. The skill compares options using evidence-based trade-offs, ensuring you choose a superior solution rather than blindly following initial instructions.

Can I use critical thinking to improve prompt clarity and safety?

Yes, you can use critical thinking to improve prompt clarity and safety. The skill refines prompts by identifying core goals, challenging hidden assumptions, and restructuring text to increase specificity while ensuring the original intent is preserved.

Does critical prompt refinement work for industries outside of software architecture?

Yes, critical prompt refinement works across industries. The skill applies structured reasoning to any plan reviews or feature requests where prompts are vague, analyzing assumptions and proposing actionable alternatives regardless of the specific domain.

When should I not use prompt refinement for my requests?

You should avoid prompt refinement when requests are already highly specific, actionable, and lack hidden assumptions. In these cases, applying structured reasoning and exploring alternative solutions may introduce unnecessary overhead without providing additional clarity.