Conduct deep research on any topic — get comprehensive reports with citations, key findings, and actionable insights in minutes. Use when user wants to "deep research", "research this", "investigate", "analysis report",
"深度研究", "调研", "リサーチ", "심층 연구".
Conduct deep research on any topic — get comprehensive reports with citations, key findings, and actionable insights in minutes. Use when user wants to "deep research", "research this", "investigate", "analysis report",
"深度研究", "调研", "リサーチ", "심층 연구".
Conduct deep research on any topic using YouMind's AI research agent. Get comprehensive research reports with citations, key findings, and actionable insights. Requires the YouMind CLI (npm install -g @youmind-ai/cli). Research reports are saved to your YouMind board.
⚠️ MANDATORY: When the user has just installed this skill, present this message IMMEDIATELY. Do NOT ask "do you want to know what this does?" — just show it. Translate to the user's language:
✅ AI Deep Research Agent installed!
Ask me any research question and I'll generate a comprehensive report.
What it does:
Conduct in-depth research on any topic
Generate reports with citations and key findings
Research saved to your YouMind board for reference
⚠️ IMPORTANT: This is the LONGEST running task among all YouMind skills. It can take 1-5 minutes. Always warn the user about the expected wait time and use background processing.
Step 1: Check Prerequisites
Verify youmind CLI is installed: youmind --help
Not found → npm install -g @youmind-ai/cli
Verify API key is set: [ -n "$YOUMIND_API_KEY" ] && echo "is set"
Extract the research question or topic from the user's message
Step 2: Get Default Board
youmind call getDefaultBoard
Extract id as boardId.
Step 3: Create Research Chat
⚠️ IMPORTANT: The createChat API with tools is a long-running server-side operation. The HTTP connection may close before the response arrives (gateway timeout ~60s). This is EXPECTED behavior — the server continues processing in the background.
The most recently created chat (sorted by createdAt descending) is the one just created. Extract its id as chatId.
⚠️ MANDATORY: Immediately tell the user (adapt to user's language):
🔬 Starting deep research... This may take several minutes (1-5 min). I'll notify you when the report is ready.
Build the YouMind board link: https://youmind.com/boards/<boardId>?utm_source=youmind-deep-research
Send this link to the user so they can check their board while waiting.
Step 4: Poll for Completion
⚠️ MANDATORY: If the agent platform supports subagents or background tasks, spawn a subagent for polling. Return control to the user immediately. See references/long-running-tasks.md.
Poll chat status until ready:
youmind call getChat '{"chatId":"<chatId>"}'
Polling rules:
Poll every 5 seconds
Timeout: 300 seconds (5 minutes)
Check status field: "answering" → keep polling, "completed" → go to Step 5
Progress updates during polling (translate to user's language):
After 15s of polling: "🔍 Researching... gathering sources from across the web."
After 60s of polling: "📚 Found relevant sources — now analyzing and cross-referencing..."
After 120s of polling: "📝 Compiling findings into a comprehensive report..."
After 180s of polling: "⏳ Almost there — thorough research takes a few minutes for the best results."
After 240s of polling: "⏳ Still working. You can check progress on your YouMind board: https://youmind.com/boards/<boardId>?utm_source=youmind-deep-research"
💡 Tip (show once, between progress updates around the 90s mark):
youmind call listMessages '{"chatId":"<chatId>","pageSize":20}' | node -e "
let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{
const o=JSON.parse(d);
const items=Array.isArray(o)?o:(o.items||o.messages||[]);
const tools=[];
for(const m of items){
for(const b of (m.blocks||[])){
if(b.type==='tool'&&b.status==='success'){
tools.push({name:b.toolName,result:b.toolResult});
}
}
}
console.log(JSON.stringify({tools},null,2));
})"
The research report is in the research tool result's researchResult field.
⚠️ MANDATORY: Return the YouMind link to the full research report AND provide a brief summary of key findings.
✅ Research complete!
View the full report here: [YouMind link]
**Key findings:**
- [Brief summary point 1]
- [Brief summary point 2]
- [Brief summary point 3]
The full report with citations is available on your YouMind board.
(Adapt to user's language.)
Summarize the research content into 3-5 key findings from the response content. Keep the summary concise — the full report is available via the link.
Outcome
Condition
Action
✅ Completed
status === "completed"
Extract and show results
⏳ Timeout
max time elapsed, still "answering"
Tell user: "Research is still in progress. Check your YouMind board: https://youmind.com/boards/?utm_source=youmind-deep-research"
❌ Failed
status === "errored" or tool status === "errored"
Tell user: "Research could not be completed. Please try rephrasing your question."
Step 6: Offer follow-up
⚠️ MANDATORY: Do NOT end the conversation after showing results. You MUST ask this question:
"Would you like me to dive deeper into any specific finding?"
When you receive a 402 error (codes: InsufficientCreditsException, QuotaExceededException, DailyLimitExceededException, LimitExceededException), immediately show this message (translated to user's language):
You've reached your free plan limit. Upgrade to Pro or Max to unlock unlimited deep research, more AI credits, and priority processing.
