name

web-research-documenter

description

This skill should be used when users request research on a topic with the intent to save findings to a document. It provides a systematic workflow for conducting web research, synthesizing information from multiple sources, and creating well-structured documentation. Trigger words include "research and save", "look up and document", "find information about and write", or any request that combines information gathering with file creation.

Web Research Documenter

Overview

This skill enables systematic web research with professional documentation output. It combines web search, content fetching, information synthesis, and structured file creation into a repeatable workflow that produces comprehensive, well-organized research documents.

When to Use This Skill

Use this skill when users request any of the following:

Technology trend research: "Research TypeScript trends and save to a file"
Competitive analysis: "Look up competitors in the AI space and document findings"
Market research: "Find information about electric vehicle market and write a report"
Tool/product comparisons: "Compare project management tools and save the analysis"
Best practices documentation: "Research React testing best practices and create a guide"
Academic literature reviews: "Find recent papers on quantum computing and summarize"
Industry analysis: "Research fintech trends and save to my reports folder"

Key indicators:

User requests both information gathering AND file creation
Request includes phrases like "research and save", "look up and document", "find and write"
User specifies a file path or directory for saving results

Research Workflow

Follow this systematic four-step workflow for all research tasks:

Step 1: Execute Multiple Web Searches

Conduct comprehensive web searches to gather diverse perspectives and up-to-date information.

Search strategy:

Start with a broad query covering the main topic
Follow up with specific queries for recent updates, versions, or features
Aim for 2-3 complementary searches to ensure comprehensive coverage

Example for "TypeScript trends":

Search 1: "TypeScript latest trends 2024 2025"
Search 2: "TypeScript 5.7 5.8 new features 2024"

Tool usage:

mcp-server-search__web_search(
  query="[main topic query]",
  max_results=10
)

Step 2: Fetch Detailed Content

When search results include authoritative sources (official blogs, documentation, reputable publications), fetch the full content for deeper insights.

Selection criteria:

Official documentation or blogs (e.g., Microsoft TypeScript blog)
Recent publication dates
High-quality sources with detailed information
Articles that directly address the research topic

Tool usage:

mcp-server-fetch__fetch(
  url="[authoritative source URL]",
  max_length=8000
)

Note: Use start_index parameter if content is truncated and more detail is needed.

Step 3: Synthesize Information

Create a well-structured summary that organizes findings into logical sections.

Documentation structure:

==============================================
[TOPIC] - Summary Report
Generated: [Date]
==============================================

1. [Main Category/Trend]
-----------------------------------------
• Key point 1
• Key point 2
• Key point 3

2. [Secondary Category]
-----------------------------------------
[Detailed information with sub-sections as needed]

3. [Additional Categories]
-----------------------------------------
[Continue organizing information logically]

==============================================
Sources:
- [List of primary sources]
==============================================

Synthesis guidelines:

Use clear hierarchical headings (ASCII art dividers for main sections)
Bullet points for scannable information
Sub-sections for detailed features or updates
Include specific version numbers, dates, statistics
Credit sources at the end
Maintain objective, informative tone

Step 4: Save to Specified Location

Write the synthesized report to the user-specified file path.

File writing approach:

Use absolute paths for reliability
Create content in chunks (25-30 lines per write operation)
First chunk: Use mode='rewrite' to create/overwrite file
Subsequent chunks: Use mode='append' to add content

Tool usage:

desktop-commander__write_file(
  path="[absolute path to file]",
  content="[first 25-30 lines]",
  mode="rewrite"
)

desktop-commander__write_file(
  path="[same absolute path]",
  content="[next 25-30 lines]",
  mode="append"
)

Path handling:

If user provides relative path, resolve to absolute path first
Create parent directories if they don't exist
Confirm successful write with clear user message

Quality Standards

Ensure research output meets these quality criteria:

Comprehensiveness

Cover multiple aspects of the topic
Include recent developments and historical context
Provide specific examples, statistics, and version numbers

Organization

Clear section hierarchy with descriptive headings
Logical flow from general to specific
Scannable format with bullet points and whitespace

Credibility

Cite authoritative sources (official blogs, documentation)
Include publication dates and version numbers
Distinguish between facts and projections

Usefulness

Actionable insights where applicable
Context for technical details
Future outlook or roadmap information when available

Example Usage

User request: "Research the latest TypeScript trends and save them to results/typescript_trends.txt"

Execution:

Web searches:
- "TypeScript latest trends 2024 2025" → 10 results
- "TypeScript 5.7 5.8 new features 2024" → 10 results
Fetch details:
- Identified official TypeScript blog post about 5.7 release
- Fetched full content for comprehensive feature details
Synthesize:
- Created structured report with sections:
  - GitHub popularity statistics
  - TypeScript 5.7 major features
  - Previous version highlights
  - Runtime integration improvements
  - Future roadmap (TypeScript 7.0)
Save:
- Resolved relative path to absolute
- Wrote 92-line comprehensive report
- Confirmed successful save to user

Output characteristics:

Professional formatting with ASCII dividers
Hierarchical organization (7 main sections)
Specific version numbers and dates
Bullet points for scannable content
Source citations at end

name

web-research-documenter

description

Web Research Documenter

Overview

When to Use This Skill

Use this skill when users request any of the following:

Technology trend research: "Research TypeScript trends and save to a file"
Competitive analysis: "Look up competitors in the AI space and document findings"
Market research: "Find information about electric vehicle market and write a report"
Tool/product comparisons: "Compare project management tools and save the analysis"
Best practices documentation: "Research React testing best practices and create a guide"
Academic literature reviews: "Find recent papers on quantum computing and summarize"
Industry analysis: "Research fintech trends and save to my reports folder"

Key indicators:

User requests both information gathering AND file creation
Request includes phrases like "research and save", "look up and document", "find and write"
User specifies a file path or directory for saving results

Research Workflow

Follow this systematic four-step workflow for all research tasks:

Step 1: Execute Multiple Web Searches

Conduct comprehensive web searches to gather diverse perspectives and up-to-date information.

Search strategy:

Start with a broad query covering the main topic
Follow up with specific queries for recent updates, versions, or features
Aim for 2-3 complementary searches to ensure comprehensive coverage

Example for "TypeScript trends":

Search 1: "TypeScript latest trends 2024 2025"
Search 2: "TypeScript 5.7 5.8 new features 2024"

Tool usage:

mcp-server-search__web_search(
  query="[main topic query]",
  max_results=10
)

Step 2: Fetch Detailed Content

When search results include authoritative sources (official blogs, documentation, reputable publications), fetch the full content for deeper insights.

Selection criteria:

Official documentation or blogs (e.g., Microsoft TypeScript blog)
Recent publication dates
High-quality sources with detailed information
Articles that directly address the research topic

Tool usage:

mcp-server-fetch__fetch(
  url="[authoritative source URL]",
  max_length=8000
)

Note: Use start_index parameter if content is truncated and more detail is needed.

Step 3: Synthesize Information

Create a well-structured summary that organizes findings into logical sections.

Documentation structure:

==============================================
[TOPIC] - Summary Report
Generated: [Date]
==============================================

1. [Main Category/Trend]
-----------------------------------------
• Key point 1
• Key point 2
• Key point 3

2. [Secondary Category]
-----------------------------------------
[Detailed information with sub-sections as needed]

3. [Additional Categories]
-----------------------------------------
[Continue organizing information logically]

==============================================
Sources:
- [List of primary sources]
==============================================

Synthesis guidelines:

Use clear hierarchical headings (ASCII art dividers for main sections)
Bullet points for scannable information
Sub-sections for detailed features or updates
Include specific version numbers, dates, statistics
Credit sources at the end
Maintain objective, informative tone

Step 4: Save to Specified Location

Write the synthesized report to the user-specified file path.

File writing approach:

Use absolute paths for reliability
Create content in chunks (25-30 lines per write operation)
First chunk: Use mode='rewrite' to create/overwrite file
Subsequent chunks: Use mode='append' to add content

Tool usage:

desktop-commander__write_file(
  path="[absolute path to file]",
  content="[first 25-30 lines]",
  mode="rewrite"
)

desktop-commander__write_file(
  path="[same absolute path]",
  content="[next 25-30 lines]",
  mode="append"
)

Path handling:

If user provides relative path, resolve to absolute path first
Create parent directories if they don't exist
Confirm successful write with clear user message

Quality Standards

Ensure research output meets these quality criteria:

Comprehensiveness

Cover multiple aspects of the topic
Include recent developments and historical context
Provide specific examples, statistics, and version numbers

Organization

Clear section hierarchy with descriptive headings
Logical flow from general to specific
Scannable format with bullet points and whitespace

Credibility

Cite authoritative sources (official blogs, documentation)
Include publication dates and version numbers
Distinguish between facts and projections

Usefulness

Actionable insights where applicable
Context for technical details
Future outlook or roadmap information when available

Example Usage

User request: "Research the latest TypeScript trends and save them to results/typescript_trends.txt"

Execution:

Web searches:
- "TypeScript latest trends 2024 2025" → 10 results
- "TypeScript 5.7 5.8 new features 2024" → 10 results
Fetch details:
- Identified official TypeScript blog post about 5.7 release
- Fetched full content for comprehensive feature details
Synthesize:
- Created structured report with sections:
  - GitHub popularity statistics
  - TypeScript 5.7 major features
  - Previous version highlights
  - Runtime integration improvements
  - Future roadmap (TypeScript 7.0)
Save:
- Resolved relative path to absolute
- Wrote 92-line comprehensive report
- Confirmed successful save to user

Output characteristics:

Professional formatting with ASCII dividers
Hierarchical organization (7 main sections)
Specific version numbers and dates
Bullet points for scannable content
Source citations at end