Skip to content

Commit ccd5a7c

Browse files
committed
docs(skills): organize web-research files in dedicated folder
Addresses TODO(Claude) to specify that all research files should be organized in a dedicated folder structure. Changes: - Added step to create /research_[topic_name]/ folder - Updated all file paths to use folder structure: - /research_plan.md → /research_[topic_name]/research_plan.md - /findings_[subtopic].md → /research_[topic_name]/findings_[subtopic].md - /research_report.md → /research_[topic_name]/research_report.md - Updated synthesis step to reference the folder Benefits: - Keeps files organized and prevents clutter in working directory - Makes it easy to manage multiple research projects - Clear file organization for subagents
1 parent d4daf97 commit ccd5a7c

File tree

1 file changed

+13
-6
lines changed

1 file changed

+13
-6
lines changed

examples/skills/web-research/SKILL.md

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,15 @@ Use this skill when you need to:
2121

2222
Before delegating to subagents, you MUST:
2323

24-
1. **Analyze the research question** - Break it down into distinct, non-overlapping subtopics
25-
2. **Write a research plan file** - Use the `write_file` tool to create `/research_plan.md` containing:
24+
1. **Create a research folder** - Organize all research files in a dedicated folder:
25+
```
26+
mkdir /research_[topic_name]/
27+
```
28+
This keeps files organized and prevents clutter in the working directory.
29+
30+
2. **Analyze the research question** - Break it down into distinct, non-overlapping subtopics
31+
32+
3. **Write a research plan file** - Use the `write_file` tool to create `/research_[topic_name]/research_plan.md` containing:
2633
- The main research question
2734
- 2-5 specific subtopics to investigate
2835
- Expected information from each subtopic
@@ -39,15 +46,15 @@ For each subtopic in your plan:
3946

4047
1. **Use the `task` tool** to spawn a research subagent with:
4148
- Clear, specific research question (no acronyms)
42-
- Instructions to write findings to a file: `/findings_[subtopic].md`
49+
- Instructions to write findings to a file: `/research_[topic_name]/findings_[subtopic].md`
4350
- Budget: 3-5 web searches maximum
4451

4552
2. **Run up to 3 subagents in parallel** for efficient research
4653

4754
**Subagent Instructions Template:**
4855
```
4956
Research [SPECIFIC TOPIC]. Use the web_search tool to gather information.
50-
After completing your research, use write_file to save your findings to /findings_[subtopic].md.
57+
After completing your research, use write_file to save your findings to /research_[topic_name]/findings_[subtopic].md.
5158
Include key facts, relevant quotes, and source URLs.
5259
Use 3-5 web searches maximum.
5360
```
@@ -56,14 +63,14 @@ Use 3-5 web searches maximum.
5663

5764
After all subagents complete:
5865

59-
1. **Use `list_files` and `read_file`** to review all findings files
66+
1. **Use `list_files` and `read_file`** to review all findings files in `/research_[topic_name]/`
6067
2. **Synthesize the information** - Create a comprehensive response that:
6168
- Directly answers the original question
6269
- Integrates insights from all subtopics
6370
- Cites specific sources with URLs
6471
- Identifies any gaps or limitations
6572

66-
3. **Write final report** (optional) - Use `write_file` to create `/research_report.md` if requested
73+
3. **Write final report** (optional) - Use `write_file` to create `/research_[topic_name]/research_report.md` if requested
6774

6875
## Available Tools
6976

0 commit comments

Comments
 (0)