theme-researcher-subagent

Delegates thematic analysis of source texts to parallel subagents and synthesizes findings into a report.

13|17|Updated Jan 30, 2025
One-click install
npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill theme-researcher-subagent-codewithsally
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theme-researcher-subagent
Source: https://github.com/CodeWithSally/CodeWithSally-Apex-English/tree/main/Sessions/ClaudeCode/Session005/.claude/skills/theme-researcher-subagent
Command: npx skills add https://github.com/CodeWithSally/CodeWithSally-Apex-English --skill theme-researcher-subagent-codewithsally

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Analyzing a theme across long books or multiple documents can overwhelm a single context window and produce shallow results. This Skill offloads the close reading to dedicated subagents—one per file—so large or numerous texts get thorough thematic analysis while the main conversation stays clean. ## Core Features & Use Cases - Parallel Subagent Analysis: Spawns one analysis subagent per file, running them concurrently for multi-file projects. - Structured Close Reading: Each subagent returns a dominant stance, key passages with locations, tensions, and a distinctive angle for the given theme. - Synthesized Report: Combines all subagent findings into a single grounded paragraph explaining how the theme functions across the material. - Use Case: A researcher provides three essay files and asks how the concept of 'labor' is treated in each; subagents read the files in parallel and the Skill returns one synthesis comparing their treatments. ## Quick Start Research the theme of exile across the attached novel chapters and tell me how it develops across the files.

Frequently Asked Questions about theme-researcher-subagent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a theme across multiple text files?

Provide the file paths and the theme you want traced. The Skill spawns one analysis subagent per file, runs them in parallel, and synthesizes their structured findings into a single paragraph covering stance, key passages, and tensions.

When should I use subagent-based thematic analysis instead of direct reading?

Use the subagent approach when source material is long, spans multiple files, or when you want to keep the main context clean. For short single texts, direct close reading without delegation is usually sufficient.

What does each analysis subagent return?

Each subagent returns a structured analysis with a dominant stance on the theme, two to three key passages with locations, tensions or surprises that complicate the reading, and the text's distinctive angle on the theme.

Can it handle very large files over 800 lines?

Yes. The subagent prompt instructs reading large files in multiple passes while tracking position, so the entire text is covered before analysis begins. Notes are taken on relevant passages throughout the reading.

What are the limitations of subagent-based theme research?

The final synthesis depends on the quality of subagent notes, so subtle cross-file connections may require explicit prompting. The output is a single paragraph, not an exhaustive citation index or chapter-by-chapter breakdown.