changes

research/deep-research/SKILL.md

@@ -1,19 +1,17 @@
 ---
 name: deep-research
 description: |
-  Comprehensive research assistant that synthesizes information from multiple sources with citations.
-  Use when: conducting in-depth research, gathering sources, writing research summaries, analyzing topics
-  from multiple perspectives, or when user mentions research, investigation, or needs synthesized analysis
-  with citations.
+  Use when conducting in-depth research, gathering sources, writing research summaries with citations,
+  or analyzing topics from multiple perspectives where evidence quality and synthesis matter.
 license: MIT
 metadata:
   author: awesome-llm-apps
-  version: "1.0.0"
+  version: "1.1.0"
 ---
 
 # Deep Research
 
-You are an expert researcher who provides thorough, well-cited analysis by synthesizing information from multiple perspectives.
+Use dedicated research subagent when available. Keep parent session focused on scope, delegation, and final synthesis.
 
 ## When to Apply
 
@@ -25,6 +23,62 @@ Use this skill when:
 - Identifying key findings and trends
 - Evaluating the quality and credibility of sources
 
+## Execution Pattern
+
+**Subagent-first:** If subagent dispatch is available and a `researcher` subagent exists, delegate research work to it. If the platform only supports generic subagents, dispatch a fresh research-focused subagent with equivalent instructions.
+
+Why:
+- preserves parent session context
+- gives research work isolated scope
+- makes source gathering and synthesis repeatable
+
+**Fallback:** If subagents are unavailable, follow the same workflow in the current session.
+
+### Delegation Checklist
+
+Before dispatch:
+- Clarify scope if the request is ambiguous
+- Write concrete coverage requirements; do not send vague prompts
+- Include citation, source-quality, and uncertainty rules
+- Include exact output sections required from the subagent
+
+### Researcher Handoff Template
+
+Send a self-contained task. Do not make the subagent infer missing requirements.
+
+```text
+Research topic: {QUESTION}
+Purpose/context: {PURPOSE}
+
+Requirements — Detailed Analysis must cover:
+- {ANGLE_OR_SUBTOPIC_1}
+- {ANGLE_OR_SUBTOPIC_2}
+- {ANGLE_OR_SUBTOPIC_3}
+
+Constraints:
+- Use numbered citations [1], [2] for every external claim
+- Prefer peer-reviewed papers, official reports, and primary sources when available
+- Flag company claims, news summaries, and weak evidence as lower-confidence
+- Call out uncertainty, disagreement, and evidence gaps explicitly
+- Research only; do not modify files
+
+Output sections:
+- Executive Summary
+- Key Findings
+- Detailed Analysis
+- Areas of Consensus
+- Areas of Debate
+- Sources
+- Gaps and Further Research
+```
+
+### After Subagent Returns
+
+- Check that claims are cited and scope is covered
+- Spot-check weak or surprising claims against sources
+- Present the final answer in the requested depth
+- Preserve uncertainty and debate where the evidence is mixed
+
 ## Research Process
 
 Follow this systematic approach:
@@ -103,6 +157,13 @@ When citing sources, note:
 - **Expert commentary** - Qualified opinions
 - **General websites** - verify independently
 
+## Common Mistakes
+
+- **Vague delegation** - "Research X" is too loose; include must-cover dimensions and output sections
+- **Missing citation rules** - Require citations for every external claim, not just the final bullet or paragraph
+- **Missing source hierarchy** - State preferred source types so lower-credibility material is labeled correctly
+- **Unqualified company claims** - Mark vendor announcements as unverified unless independent evidence supports them
+
 ## Example
 
 **User Request:** "Research the benefits and risks of intermittent fasting"