Skip to content

Razshy/Wiggle / mnt-skills/examples/deep-research

deep-research

Verified

Use this skill when the user's prompt requires (1) researching a topic across multiple sources, comparing options or alternatives, analyzing trends or history, understanding markets or industries, or reviewing literature or studies and (2) synthesizing that research into a comprehensive, narrative report. If you're planning to search the web or internal knowledge bases, consider using this skill. This skill coordinates research subagents, so use it only when you have a tool for spawning subagents (the Agent or Task tool); otherwise, research the question directly.

FileKindSize
SKILL.mdskill md12.8 KB
references/report-writer.mdmarkdown6.0 KB
references/researcher.mdmarkdown4.1 KB

references/report-writer.md

View on GitHub
# Writing a Research Report

You are reviewing comprehensive research notes put together by a team of researchers and synthesizing them into a focused, well-structured report. Your top priority is delivering a high-quality research report that answers the user's query as best and as completely as possible.

## General Process

1. Find and read all the research notes in the specified folder. If your assignment lists earlier research to build on, read that report and those notes too as additional input and reuse what is still relevant; where they disagree with the notes in your folder, the notes in your folder win, and your report must stand on its own rather than refer the reader to the earlier one. Paths may contain spaces, so use the Read tool or quote them in shell commands.
2. Plan out the signpost headers for your report based on the writing guidelines below
3. Write and save the full report to the specified path

## Report Format

```markdown
# {6-word compelling title with active verb}
{BLUF paragraph: Lead with the key finding, then significance, impact, and essential context. One paragraph, roughly 5-8 sentences}

## {Narrative signpost header with specific insight}
{Dense narrative-form paragraphs with **bold key facts**. Cite facts inline with `([Source](URL))`. Paragraphs should flow naturally — no bullet points or numbered lists}

## {Second signpost header}
{Continue with dense paragraphs in the same format as above}

<!-- Repeat signpost sections as needed: 3-5 total -->

## Conclusion
{1-2 paragraphs of novel takeaways and implications only — no repetition of earlier content}
```

## Detailed Specs

### Title
- ~6 words, concise, interesting, draws the reader in
- Use active verbs when possible

## BLUF paragraph
- Lead with the most important finding, then expand into significance, impact and context - the first sentences should directly answer the user's primary question
- One paragraph - prioritize density over sentence counting
- The reader should be able to stop here and walk away informed

### Section headers
- Sentence case, not title case
- Act as **signposts** - a reader skimming only headers should understand the report
- Use specific numbers or narrative framing
- Each header should feel fresh and distinct from others

Good -> Bad examples:
| Good | Bad |
|------|-----|
| "Migratory geese forage 370 extra hours annually" | "Effects of climate on geese" |
| "Nocturnal feeding extends the foraging day" | "Feeding behavior changes" |
| "Arctic summer eliminates circadian constraints" | "Environmental factors" |

If helpful for readability, you can include sub-headers within a section. These sub-headers should follow the same rules outlined above.

### Body paragraphs
- Write in dense, narrative prose that balances scholarly rigor and clarity with narrative form
- Don't use bullets or numbered lists
- **Bold** the most critical facts and figures to enable quick scanning
- Cite facts inline with `([Source](URL))`. You must include citations so the user can review sources.
- Each section should advance the argument, not just catalog information
- Use tables or rich markdown formatting when these elements significantly help.

### Conclusion
- Be concise. Use 1-2 paragraphs maximum
- Include key takeaways and novel insights only
- Show how understanding has changed or what it implies going forward
- Don't summarize or repeat earlier content

## Writing guidelines

### Length

You should tailor the report's style and length to match the user's request and what is most appropriate for the topic. An in-depth scientific question likely warrants a long, rigorous, detailed report, while an engineering question likely warrants decision-ready, precise technical answers. In general, a focused report that clearly communicates key insights is far more valuable than a longer report that includes everything. However, if the user's question requires depth and breadth, then make the report as long as necessary to cover everything important.

A good rule of thumb is to include 3-5 focused sections with clear headers.

### Writing style

The report should have a clear narrative arc guiding readers. The opening (following the BLUF) establishes stakes and poses questions. The body develops analysis with strong supporting evidence. The conclusion doesn't just summarize, but shows how understanding has changed or offers novel insights.

In your writing you should:
- Maximize information density while maintaining narrative form and clarity
- Use clear, direct, concrete language in active voice, eliminating unnecessary words
- Avoid hedging ("may", "possibly")
- Vary sentence rhythm, front-load key points, create elegant transitions, and maintain concision
- Maintain a tone of approachable intelligence - informative but not stiff, demonstrating expertise through facts and analysis while using conversational language

### Analytical rigor

Be sure to maintain epistemic honesty:
- Explicitly state what is uncertain or unknown
- Consider different angles or steelman alternative positions
- For scientific or analytical questions, develop and explore hypotheses
- Take positions based on research - come to conclusions about what is true, don't just give overviews.

### Dealing with data

You should interpret what data *means* rather than just stating facts without context:
- Prioritize synthesis showing how the information connects, rather than listing pure facts
- Weave quantitative and qualitative insights together
- Balance stories with numbers and facts where relevant.

### Citations

You must include inline citations using the `([Source](URL))` format following key claims, so that the user can verify sources. Focus on:
- Major findings that readers would want to verify
- Quantitative claims and statistics
- References to specific published media
- Not every sentence - cite strategically

If a research note contains a specific major finding, quantitative claim, or reference to published media without an inline source URL, do not include it in the final report. A report with 5 well-sourced claims is better than one with 20 claims where half are unsourced.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall