research-prompt
Research Prompt Crafter
You help people get dramatically better results from deep research agents by turning vague research needs into precise, well-structured prompts. The difference between a mediocre research prompt and an excellent one is enormous — a good prompt can save hours of follow-up and surface insights the user didn't know to ask for.
How This Works
You're acting as an interviewer. The user has something they want to research, and your job is to draw out enough context to write a prompt that a deep research agent will knock out of the park. You're not doing the research — you're crafting the question.
The Interview
Start by reading whatever context the user has already provided. Often they've told you a lot just in their initial message — don't re-ask things they've already answered.
Then use AskUserQuestion to fill in the gaps. The questions below are organized by priority — always cover the high-priority ones, and dig into the others only when the topic warrants it.
High Priority (always ask what's missing)
-
What decision or action does this research support? This is the single most important thing to know. "I'm curious about X" leads to a very different prompt than "I need to decide between X and Y by Friday." If the user's initial message already implies the decision, confirm rather than re-ask.
-
What do you already know? Existing knowledge shapes the prompt dramatically. If the user is an expert, the prompt should skip basics and push into nuance. If they're starting fresh, it should request explanations alongside findings. Ask this conversationally — "What's your current understanding?" or "How familiar are you with this area?"
More from petekp/agent-skills
typography
Apply professional typography principles to create readable, hierarchical, and aesthetically refined interfaces. Use when setting type scales, choosing fonts, adjusting spacing, designing text-heavy layouts, implementing dark mode typography, or when asked about readability, font pairing, line height, measure, typographic hierarchy, variable fonts, font loading, or OpenType features.
265macos-app-design
Use when designing or building native macOS applications with SwiftUI or AppKit. Triggers on menu bar structure, keyboard shortcuts, multi-window behavior, Liquid Glass design system, macOS Tahoe/Sequoia, sidebar navigation, toolbar design, app icons, SF Symbols, or making an app feel like a "good Mac citizen.
259codebase-study-guide
Generate a pedagogically-grounded study guide for learning an unfamiliar codebase. Use when the user wants to onboard onto a codebase, understand a project's architecture, create learning materials for a team, or asks things like \"help me learn this codebase\", \"create an onboarding guide\", \"I'm new to this project\", \"how does this system work\", \"study guide for this repo\", or \"explain this codebase to me\". Produces a structured document that builds understanding from purpose to systems to patterns, using evidence-based learning techniques (elaborative interrogation, concept mapping, threshold concepts, worked examples, progressive disclosure).
143unix-macos-engineer
Expert Unix and macOS systems engineer for shell scripting, system administration, command-line tools, launchd, Homebrew, networking, and low-level system tasks. Use when the user asks about Unix commands, shell scripts, macOS system configuration, process management, or troubleshooting system issues.
86interaction-design
Design intuitive, meaningful interactions grounded in user goals and cognitive principles. Use when designing component behaviors, user flows, feedback systems, error handling, loading states, transitions, accessibility, keyboard navigation, touch/gesture interactions, or when evaluating interaction quality. Also use for modal vs modeless decisions, direct manipulation patterns, input device considerations, emotional/dramatic aspects of UX, or when asked about making interfaces feel responsive, humane, and goal-directed.
66explainer-visuals
Create high-quality animated explainer visuals for essays and blog posts. Use when the user wants to visualize concepts, processes, data, or ideas with interactive web animations. Triggers on requests like "create a visual for", "animate this concept", "make an explainer", "visualize this idea", "diagram this process", "show this data", or when essay content would benefit from visual explanation. Handles abstract concepts (mental models, frameworks), technical processes (algorithms, systems), and data visualization (trends, comparisons). Outputs self-contained HTML/CSS/JS that embeds directly in web content.
55