Free Agent Skill
Prompt Refiner
Turns a vague request into an executable brief without silently inventing missing requirements.
Use when: A prompt is broad, underspecified or producing generic output.
Install this skill
Cursor, Claude Code and Codex
- Create a folder named `prompt-refiner`.
- Save the skill content below as `SKILL.md` inside that folder.
- Place the folder in `.cursor/skills/` for Cursor or `.claude/skills/` for Claude Code (or the equivalent path for Codex).
- Describe the task normally. Your agent loads the skill when its description matches.
Use this in ChatGPT or Claude (no code)
- Copy or download SKILL.md from this page (or put it in a folder named
prompt-refiner). - Zip that folder so the archive contains
prompt-refiner/SKILL.md. - In ChatGPT (Business, Enterprise, Edu or Healthcare), upload the zip under workspace Skills. In Claude.ai, add a Skill from the zip where your plan supports Skills.
- Describe the task in plain language — the skill loads when its description matches.
---
name: prompt-refiner
description: Refine vague or underspecified requests into executable prompts. Use when a user asks to improve a prompt, the desired outcome is unclear, or an AI keeps returning generic output.
---
# Prompt Refiner
Turn the request into a brief an agent can execute and verify.
## Method
1. State the intended outcome in one sentence.
2. Extract known context, audience, constraints, inputs and required output.
3. Identify only the unknowns that would materially change the result.
4. Resolve low-risk gaps with explicit assumptions. Ask at most three focused questions for material gaps.
5. Write the refined prompt with:
- role and objective
- relevant context and source material
- constraints and exclusions
- required output structure
- success checks
6. Remove filler, duplicated instructions and invented facts.
## Output
Return:
- **Refined prompt**
- **Assumptions made**
- **Open question**, only when execution is genuinely blocked
Do not execute the refined prompt unless the user asks you to.
More free skills
Decision Framer
Separates the real choice from noise, then tests options against explicit criteria and uncertainty.
Meeting to Actions
Converts messy notes into decisions, owned actions, deadlines and unresolved questions.
Agent Charter
Write a one-page charter for an AI agent or bot staff member: one job, anti-jobs, what needs human approval, what is never allowed, and how it proves work
Calibrated Forecasting
Turn a vague prediction or unstated confidence level into an explicit, calibrated probability estimate, using superforecasting practices — breaking questions into sub-questions, checking base rates, updating in small increments as new information arrives, and tracking predictions against outcomes
Decision Memo
Structure a real, consequential decision as a written narrative memo — full sentences and paragraphs rather than bullet points, forcing the logic to be checked rather than gestured at, plus explicit classification of whether the decision is reversible (a "two-way door") or not (a "one-way door")
Teachback
Test and build genuine understanding of a concept using teachback — explain it as simply as possible, notice exactly where the simple explanation breaks down, and treat that break point as the thing to actually go learn
First Principles
Rebuild a problem from fundamental truths (physics, economics, unit costs, what's actually true regardless of convention) rather than by analogy to how things are normally done
Focus and Tradeoffs
Cut a bloated plan, roadmap, or list of priorities down to the one or two things that actually matter — real focus means saying no to a thousand things
Jobs to Be Done
Diagnose what "job" a customer is actually hiring a product, service, or workaround to do, using the Jobs-to-be-Done framework — progress in a specific circumstance, forces of progress, switch interview, job statements, and desired-outcome scoring
Mental Models
Apply a latticework of cross-disciplinary thinking tools (inversion, second-order effects, incentives, circle of competence, opportunity cost, base rates) to frame a vague or general problem
Moat Analysis
Assess whether a competitive advantage is durable (a real "moat") or temporary, by checking it against the standard sources of durable advantage — switching costs, network effects, economies of scale, brand/trust, and regulatory or IP protection — rather than taking "we're ahead right now" at face value
Negotiation Prep
Prepare for a high-stakes negotiation or hard conversation using tactical-empathy techniques — labeling emotions, calibrated open-ended questions, mirroring, and getting to genuine "that's right" rather than a grudging "yes."
Postmortem / Retro
Extract a specific, reusable lesson after something succeeded or failed, following the principle that pain plus reflection equals progress — outcomes only compound into better judgment if they're deliberately converted into a written, checkable lesson rather than just felt and moved past
Premortem
Run a premortem — imagine a plan has already failed and work backward to explain why, which surfaces risks that forward planning misses because it counteracts the social and psychological pressure to seem confident
More skills on the way.
Subscribe to How I Grok Bot for new free skills and practical notes on running AI agent workflows.