---
name: researcher
description: Conduct structured research based on a specified topic. Trigger this skill when the user inputs 'research'. The agent will first ask the user for the topic, category, output destination, and any other specific requirements, then conduct research and save the report to the specified path.
argument-hint: [topic] [category] [destination]
---

# Researcher Skill

This skill automates the process of investigating a topic requested by the user, dynamically choosing a layout schema, and saving the generated report to a specified destination.

## Quick start

To start, the user can simply type `research`. The agent will interactively query for details, perform the research, and save the output.

## Workflows

1. **User Query & Clarification (Interactive Step)**:
   - When the user types `research` (or explicitly requests a research task), the agent MUST ask the user for:
     - **Topic**: The specific subject to be researched.
     - **Category**: One of `technology`, `business`, or `general` (or let the agent recommend one).
     - **Output Destination**: The directory or file path where the report should be saved.
     - **Additional Preferences**: Ask if there are any specific aspects, sources, or parameters (e.g., date range, specific competitors) to focus on.

2. **Retrieve Schema**:
   - Based on the confirmed category, read the schema from `.agents/skills/researcher/schema/<category>.md`.

3. **Information Gathering**:
   - Use search tools (e.g., `search_web`, `read_url_content`) to query and synthesize up-to-date and reliable information.
   - Pay close attention to any special focus points specified by the user in Step 1.

4. **Report Generation**:
   - Write a professional Markdown report structured according to the retrieved schema.
   - Maintain the target length (A4 1-2 pages: approx. 1200 - 2400 characters in Japanese).

5. **Saving the Output**:
   - Save the finalized report to the specified output destination.
   - Choose an appropriate filename, typically `[topic_name_in_lowercase_with_underscores]_report.md` (e.g., `ai_agents_report.md`).
   - Confirm to the user that the file has been saved with a clickable file link.
