| name | deep-reading-agent-skill |
| description | MANDATORY. DO NOT synthesize, summarize, or analyze any complex resource (PDFs, docs, web pages) without calling 'activate_skill' on 'deep-reading-agent-skill' first. This is the REQUIRED PROTOCOL for deep-dive analysis and sectional reflection. This skill is the MANDATORY GATEWAY for any task involving 'reading deeply', 'analyzing nuances', 'reflecting on the spirit', or 'extracting deep insights'. TRIGGER THIS SKILL IMMEDIATELY for all synthesis and detailed research tasks. It prevents 'surface-level reading' and ensures a comprehensive understanding of a resource's core message and underlying details through a strict section-by-section audit. Use it to maintain high-signal synthesis for long-form resources. Proceeding with analysis without this deep-reading protocol constitutes a protocol failure. |
| compatibility | Requires Node.js or Docker for sectional coverage validation. |
| metadata | {"version":"1.1.0","category":"research"} |
Deep Reading Agent Skill: Nuance & Connection Framework
This skill provides a strict procedural framework for deeply reading and reflecting on resources. Your objective is to move beyond superficial summaries and instead strive to understand the underlying nuances, concepts, and the spirit of the material. This is a rigorous, multi-layered approach to comprehension.
CRITICAL MANDATE: You must read the resources one by one, section by section. Do not skip ahead or stop at summaries and conclusions. You must explicitly reflect on each section before moving to the next.
CRITICAL RULES & GUARDRAILS
- File Hygiene: You MUST save all intermediate and final reports to the
artifacts/ folder at the project root (it is already ignored by git). DO NOT pollute the root directory or system folders.
- Progressive Disclosure: For verbose definitions of "Nuance," "Concept," and "Spirit," you MUST read
references/methodology.md before starting Phase 1.
- Negative Constraint: Do NOT skip the sectional reflection phase. Superficial summaries are forbidden.
- Validation: You MUST run the
validate_router.sh script. It uses a proprietary heuristic to score the depth, nuance, and semantic variety of your reflection. It will fail if it detects word-padding, generic paraphrasing, or lack of genuine insight.
- Stateful Interaction: You MUST maintain the Execution State checklist.
WORKFLOW: [Deep Reading Protocol]
Follow these 4 mandatory phases precisely.
MECHANICAL CoT REQUIRED: You MUST copy the checklist below into your output and check off the boxes as you progress to track your state.
### Execution State:
- [ ] Phase 1: Sectional Deep Reflection
- [ ] Phase 2: Holistic Resource Reflection
- [ ] Phase 3: Cross-Resource Synthesis (if multiple)
- [ ] Phase 4: Final Synthesis & Deep Insight
Phase 1: Sectional Deep Reflection
For every section of a resource (e.g., chapters, headings, key segments):
- Read the Section: Read the entire text of the section carefully.
- Reflect on Nuance: What is the specific tone, the hidden assumptions, or the subtle distinctions the author is making?
- Synthesize Concepts: What are the core ideas introduced? How do they differ from similar concepts you've encountered?
- Capture the Spirit: What is the overarching intent or "soul" of this section?
- Validation: Run
bash scripts/validate_router.sh sectional_report.md to ensure coverage.
Phase 2: Holistic Resource Reflection
Once the entire resource has been read section by section:
- Read the Whole Again (Mental Model): Reflect on how the sections you've analyzed build upon each other.
- Reflect on the Spirit of the Resource: What is the ultimate goal or "spirit" of the entire work?
- Identify Meta-Nuances: Are there themes or messages that only emerge when looking at the complete resource?
- Validation: Run
bash scripts/validate_router.sh holistic_report.md.
Phase 3: Cross-Resource Synthesis (For Multiple Resources)
After completing Phases 1 and 2 for all provided resources:
- Reflect on the Combination: How do these resources interact? Do they complement, contradict, or extend each other?
- Synthesize the "Combined Spirit": If these resources were part of a single ecosystem or philosophy, what would that be?
- Deep Connection Mapping: Identify specific nuances in one resource that are clarified or challenged by another.
Phase 4: Final Synthesis & Deep Insight
Produce a final report that captures the deepest insights gained from this entire process. This report must avoid generic summaries and instead focus on the profound understanding of the concepts and their interplay.
Triggers
- "read the following resources deeply"
- "deeply read this PDF section by section"
- "analyze the nuances and spirit of these documents"
- "read [X] one by one, section by section"
Negative Triggers
- "summarize this resource"
- "give me a TL;DR"
- "what are the main points of [X]?" (Too superficial)
