@demig0d2/skills 1.0.0

package/skills/research-aggregator/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: research-aggregator
+version: 1.0.0
+description: |
+  Given a book's concept document and TOC, aggregates relevant quotes, thinkers,
+  frameworks, data points, anecdotes, and philosophical references — organized by
+  chapter — for use during the writing phase. Use after TOC is approved and before
+  chapter writing begins. Produces a Research Bank document the book-writer draws from.
+  Do NOT use for fiction books where no external references are needed.
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - WebSearch
+---
+
+# Research Aggregator
+
+## Scripts
+
+Save the research bank as `research_bank.json` after building it.
+
+**Validate bank quality** (checks quote lengths, banned sources, missing fields):
+```bash
+python scripts/bank_formatter.py research_bank.json --validate
+```
+
+**View formatted bank:**
+```bash
+python scripts/bank_formatter.py research_bank.json
+python scripts/bank_formatter.py research_bank.json --chapter 3  # single chapter
+```
+
+**Export as JSON for pipeline use:**
+```bash
+python scripts/bank_formatter.py research_bank.json --json
+```
+
+## References
+
+`references/thinkers_reference.md` — Curated thinkers, works, and pre-validated quotes
+aligned with Vivid's genres (Philosophy/Essay, Self-help, Non-fiction/Technical).
+Read when: building philosophical anchors or selecting quotes for any chapter.
+
+**Always read the thinkers reference before selecting sources.**
+It includes a banned sources list and overexposed quotes to avoid.
+
+You build the Research Bank — a structured reference document organized by chapter that
+the book-writer draws from during writing. Quality over quantity. Every item must earn
+its place by being genuinely usable in the writing, not just topically adjacent.
+
+---
+
+## TRIGGER
+
+Activate after Phase 4 (TOC approval) in the book-writing workflow, or when the user says:
+- "Find references for my book"
+- "Research this topic for my book"
+- "Build a research bank for [book title/topic]"
+
+---
+
+## INPUT REQUIRED
+
+1. The approved Table of Contents (chapter titles + structure)
+2. The concept document (especially: core question, themes, reader profile)
+3. Genre (determines what kind of research is most useful)
+
+---
+
+## RESEARCH CATEGORIES
+
+For each chapter, gather items across these categories (not all are needed for every chapter):
+
+### A. Philosophical / Intellectual Anchors
+Thinkers, frameworks, or ideas that resonate with the chapter's theme.
+Format: `[Thinker/Work] — [Core idea in 1 sentence] — [How it connects to this chapter]`
+
+Vivid's approach: he arrives at these truths through experience, then names the concept.
+So these are NOT citations to use directly — they're conceptual validation. Max 1 per chapter
+should appear in the final text. The rest are background scaffolding.
+
+Priority thinkers for Vivid's genres:
+- Philosophy of identity: Epictetus, Marcus Aurelius, Simone de Beauvoir, Sartre, Camus
+- Solitude / inner life: Rilke, Thoreau, Pascal, Kierkegaard, Montaigne
+- Psychology of self: Carl Rogers, Viktor Frankl, Nathaniel Branden
+- Eastern frameworks: Stoicism, Advaita Vedanta concepts (non-attachment, witness consciousness)
+- Modern psychology: attachment theory, self-determination theory, cognitive defusion (ACT)
+
+### B. Empirical / Research Anchors
+Studies, data, or documented findings relevant to the chapter's claims.
+Format: `[Finding in plain English] — [Source if known or searchable] — [Chapter application]`
+
+Use sparingly — Vivid is not a data-heavy writer. 1–2 per chapter max.
+Prioritize: psychology studies, behavioral research, neuroscience of emotion.
+
+### C. Quotes
+Powerful, precise quotes that could open a chapter or punctuate a key insight.
+Format: `"[Quote]" — [Author, Work if known]`
+
+Standards for a usable quote:
+- Under 30 words
+- Not overused (no "Be the change," no "The unexamined life")
+- Says something that earns a standalone line
+- Vivid would have thought of this himself — the quote confirms, not compensates
+
+### D. Anecdote / Case Study Templates
+Brief real-world examples or documented cases that illustrate the chapter's theme.
+These are NOT about name-dropping celebrities. Prioritize: ordinary people, historical figures
+with specific documented experiences, or well-known stories with fresh angles.
+
+### E. Conceptual Oppositions
+The strongest counterargument to the chapter's central claim. Useful for:
+- Anticipating reader resistance
+- Building nuance into the argument
+- Structuring the "wrong attempts" section of the pain-to-transformation arc
+
+---
+
+## OUTPUT FORMAT
+
+Produce one Research Bank document structured like this:
+
+```
+RESEARCH BANK — [Book Title]
+Generated for: [TOC chapters listed]
+═══════════════════════════════════════════════════════
+
+GLOBAL ANCHORS (apply to the whole book, not a single chapter)
+───────────────────────────────────────────────────────
+[3–5 foundational ideas/thinkers/quotes that are thematic to the entire manuscript]
+
+═══════════════════════════════════════════════════════
+
+CHAPTER 1: [Title]
+───────────────────────────────────────────────────────
+Theme reminder: [one sentence on what this chapter is about]
+
+Philosophical anchors:
+• [item]
+• [item]
+
+Quotes:
+• "[quote]" — [Author]
+• "[quote]" — [Author]
+
+Research/data:
+• [finding + source]
+
+Conceptual opposition:
+• [The best argument against this chapter's claim]
+
+Writing notes:
+[Any specific suggestions for how to deploy this research in Vivid's style —
+e.g., "Don't cite Epictetus directly — arrive at his conclusion through the story,
+then let the quote confirm it at the end"]
+
+═══════════════════════════════════════════════════════
+
+CHAPTER 2: [Title]
+[same structure]
+
+...
+═══════════════════════════════════════════════════════
+
+UNUSED BUT NOTABLE
+[Interesting material that didn't fit a specific chapter but could be useful]
+```
+
+---
+
+## QUALITY FILTERS
+
+Before adding any item to the Research Bank, ask:
+1. Would Vivid actually use this? (Does it fit his voice and approach?)
+2. Is this specific enough to be useful? (No vague attributions — "researchers say" fails)
+3. Does this enrich or just decorate? (Decoration gets cut)
+4. Is the quote clean enough to stand alone without explanation?
+
+Remove anything that fails these filters.
+
+---
+
+## VIVID-SPECIFIC RESEARCH RULES
+
+- **No pop-psychology self-help citations** (no Tony Robbins, no Brené Brown framework
+  names, no "growth mindset")
+- **No overexposed quotes** (Einstein on insanity, Churchill, Mandela patience quote)
+- **Prioritize: philosophers who wrote from lived struggle** (Marcus Aurelius in war,
+  Frankl in camps, Montaigne in grief)
+- **Favor precision over prestige** — a precise quote from an unknown thinker beats a
+  famous vague one
+- **Eastern philosophy welcome but used lightly** — Vivid's framework is his own; external
+  philosophy is seasoning, not the meal

package/skills/research-aggregator/references/thinkers_reference.md

@@ -0,0 +1,104 @@
+# Thinkers Reference — Vivid's Genres
+
+Curated reference of thinkers, works, and ideas aligned with Vivid's
+writing genres: Philosophy/Essay, Self-help/Motivational, Non-fiction/Technical.
+
+Use as scaffolding — not direct citation. Vivid arrives at these conclusions
+through experience, then names them simply. Max 1 citation per chapter.
+
+---
+
+## SOLITUDE & INNER LIFE
+
+| Thinker | Key Work | Core Idea | Chapter Applications |
+|---|---|---|---|
+| Rainer Maria Rilke | Letters to a Young Poet | Solitude as the place where creation and self-knowledge happen | Chapters on embracing aloneness, inner world |
+| Blaise Pascal | Pensées | "All of humanity's problems stem from man's inability to sit quietly in a room alone" | Chapters on distraction, running from self |
+| Henry David Thoreau | Walden | Deliberate solitude as the condition for genuine life | Chapters on choosing aloneness |
+| Søren Kierkegaard | The Sickness Unto Death | The self must relate itself to itself | Chapters on self-relationship, identity |
+| Michel de Montaigne | Essays | "The greatest thing in the world is to know how to belong to oneself" | Chapter closings, independence |
+
+---
+
+## PHILOSOPHY OF IDENTITY & SELF
+
+| Thinker | Key Work | Core Idea | Chapter Applications |
+|---|---|---|---|
+| Epictetus | Enchiridion | Distinguish what is in your control from what is not | Chapters on letting go, acceptance |
+| Marcus Aurelius | Meditations | The inner citadel — strength from within regardless of external events | Emotional independence chapters |
+| Albert Camus | The Myth of Sisyphus | Finding meaning in the absence of inherent meaning | Chapters on finding purpose alone |
+| Jean-Paul Sartre | Existentialism is a Humanism | Existence precedes essence — you define yourself | Identity chapters |
+| Viktor Frankl | Man's Search for Meaning | Meaning can be found in suffering; no one can take your inner freedom | Chapters on finding strength in hardship |
+
+---
+
+## PSYCHOLOGY OF SELF & RELATIONSHIPS
+
+| Thinker | Key Work | Core Idea | Chapter Applications |
+|---|---|---|---|
+| Carl Rogers | On Becoming a Person | Unconditional positive self-regard as the foundation of health | Self-acceptance chapters |
+| Nathaniel Branden | The Six Pillars of Self-Esteem | Self-esteem as self-efficacy + self-respect | Self-worth chapters |
+| John Bowlby | Attachment Theory | Anxious attachment drives compulsive connection-seeking | Chapters on chasing connection |
+| Harriet Lerner | The Dance of Anger | Pursuing and distancing patterns in relationships | Chapters on relational patterns |
+
+---
+
+## EASTERN & CONTEMPLATIVE FRAMEWORKS
+
+| Framework | Core Idea | Chapter Applications |
+|---|---|---|
+| Non-attachment (Buddhist/Vedic) | Suffering arises from clinging — to people, outcomes, self-image | Chapters on letting go of outcomes |
+| Witness consciousness (Advaita) | The observer within who watches without judgment | Chapters on self-reflection |
+| Stoic practice | Focus exclusively on what is within your sphere of influence | Chapters on control, acceptance |
+| Wabi-sabi (Japanese) | Finding beauty in imperfection and impermanence | Chapters on accepting the self as incomplete |
+
+---
+
+## QUOTES — VIVID-APPROPRIATE (pre-validated)
+
+All under 30 words. None overexposed.
+
+**Solitude & Self:**
+- "The capacity to be alone is the capacity to love." — Osho
+- "In solitude the mind gains strength and learns to lean upon itself." — Laurence Sterne
+- "I exist as I am, that is enough." — Walt Whitman
+- "To be alone is to be different, to be different is to be alone." — Suzanne Gordon
+
+**Identity & Strength:**
+- "He who knows others is wise; he who knows himself is enlightened." — Lao Tzu
+- "You are enough just as you are." — Meghan Markle (quoting Brené Brown — better to find original)
+- "The privilege of a lifetime is to become who you truly are." — Carl Jung
+- "Without great solitude, no serious work is possible." — Pablo Picasso
+
+**Pain & Growth:**
+- "The wound is the place where the Light enters you." — Rumi
+- "Out of suffering have emerged the strongest souls." — Khalil Gibran
+- "Rock bottom became the solid foundation on which I rebuilt my life." — J.K. Rowling
+
+---
+
+## WHAT TO AVOID
+
+### Sources that conflict with Vivid's voice:
+- Tony Robbins, Brené Brown (pop psychology — too mainstream)
+- Gary Vee, Grant Cardone (hustle culture)
+- Marie Kondo, life-hack culture
+- Any quote from a "motivational poster"
+
+### Overexposed quotes (never use):
+- "Be the change you wish to see in the world" (misattributed to Gandhi)
+- "The unexamined life is not worth living" (Socrates — too academic)
+- "Insanity is doing the same thing and expecting different results" (misattributed to Einstein)
+- "You miss 100% of the shots you don't take" (Wayne Gretzky via Michael Scott)
+- "In the middle of difficulty lies opportunity" (Einstein)
+
+---
+
+## HOW TO USE THIS REFERENCE
+
+1. Identify the chapter's core theme
+2. Find 1–2 relevant thinkers from this list
+3. Note the **core idea** — use this as scaffolding, not as text
+4. Write the chapter so Vivid arrives at this idea through experience
+5. If the quote is perfect and under 30 words: use it once, at the end, to confirm
+6. Never open a chapter with a quote from a thinker — earn the insight first

package/skills/research-aggregator/scripts/bank_formatter.py

@@ -0,0 +1,206 @@
+#!/usr/bin/env python3
+"""
+bank_formatter.py — Format and validate a research bank
+
+Reads a research bank JSON or markdown file and outputs a
+structured, validated bank ready for the book-writer to use.
+Also validates quote lengths and source attribution.
+
+Usage:
+    python bank_formatter.py <bank.json>
+    python bank_formatter.py <bank.json> --chapter 3
+    python bank_formatter.py <bank.json> --validate
+    python bank_formatter.py <bank.json> --markdown
+"""
+
+import sys
+import re
+import json
+import argparse
+from pathlib import Path
+
+MAX_QUOTE_WORDS = 30
+
+# ─── Banned / Overexposed Terms ───────────────────────────────────────────────
+
+BANNED_SOURCES = [
+    "tony robbins", "brené brown", "marie kondo", "simon sinek",
+    "gary vee", "gary vaynerchuk", "oprah",
+]
+
+OVEREXPOSED_QUOTES = [
+    "be the change you wish to see",
+    "the unexamined life is not worth living",
+    "insanity is doing the same thing",
+    "you miss 100% of the shots",
+    "it always seems impossible until it's done",
+    "in the middle of difficulty lies opportunity",
+    "the only way to do great work",
+]
+
+
+def validate_quote(quote: str) -> list:
+    """Return list of issues with a quote."""
+    issues = []
+    words = quote.split()
+    if len(words) > MAX_QUOTE_WORDS:
+        issues.append(f"Quote too long ({len(words)} words, max {MAX_QUOTE_WORDS})")
+
+    quote_lower = quote.lower()
+    for overexposed in OVEREXPOSED_QUOTES:
+        if overexposed in quote_lower:
+            issues.append(f"Overexposed quote detected — find something more original")
+            break
+
+    return issues
+
+
+def validate_source(source: str) -> list:
+    """Return list of issues with a source attribution."""
+    issues = []
+    source_lower = source.lower()
+
+    for banned in BANNED_SOURCES:
+        if banned in source_lower:
+            issues.append(f"Pop-psychology source not aligned with Vivid's voice: {source}")
+
+    if source.lower() in ("unknown", "anonymous", "") :
+        issues.append("Source is unknown — verify or remove")
+
+    return issues
+
+
+def validate_bank(bank: dict) -> dict:
+    """Run full validation on a research bank."""
+    all_issues = []
+
+    for chapter_key, chapter_data in bank.get("chapters", {}).items():
+        chapter_issues = []
+
+        for quote_item in chapter_data.get("quotes", []):
+            quote = quote_item.get("quote", "")
+            source = quote_item.get("source", "")
+            q_issues = validate_quote(quote)
+            s_issues = validate_source(source)
+            if q_issues or s_issues:
+                chapter_issues.append({
+                    "chapter": chapter_key,
+                    "type": "quote",
+                    "content": quote[:60],
+                    "issues": q_issues + s_issues,
+                })
+
+        for anchor in chapter_data.get("philosophical_anchors", []):
+            if not anchor.get("connection"):
+                chapter_issues.append({
+                    "chapter": chapter_key,
+                    "type": "anchor",
+                    "content": str(anchor)[:60],
+                    "issues": ["Missing 'connection' field — how does this relate to the chapter?"],
+                })
+
+        all_issues.extend(chapter_issues)
+
+    return {
+        "total_issues": len(all_issues),
+        "clean": len(all_issues) == 0,
+        "issues": all_issues,
+    }
+
+
+def format_chapter_bank(chapter_key: str, chapter_data: dict) -> str:
+    lines = []
+    lines.append(f"\n{'─' * 56}")
+    lines.append(f"CHAPTER {chapter_key}: {chapter_data.get('title', '')}")
+    lines.append(f"Theme: {chapter_data.get('theme', 'Not specified')}")
+
+    anchors = chapter_data.get("philosophical_anchors", [])
+    if anchors:
+        lines.append(f"\nPhilosophical anchors:")
+        for a in anchors:
+            thinker = a.get("thinker", "Unknown")
+            idea = a.get("idea", "")
+            connection = a.get("connection", "")
+            lines.append(f"  • {thinker} — {idea}")
+            if connection:
+                lines.append(f"    → {connection}")
+
+    quotes = chapter_data.get("quotes", [])
+    if quotes:
+        lines.append(f"\nQuotes ({len(quotes)}):")
+        for q in quotes:
+            lines.append(f"  \"{q.get('quote', '')}\"")
+            lines.append(f"  — {q.get('source', 'Unknown')}")
+
+    research = chapter_data.get("research", [])
+    if research:
+        lines.append(f"\nResearch / data:")
+        for r in research:
+            lines.append(f"  • {r.get('finding', '')} [{r.get('source', '')}]")
+
+    opposition = chapter_data.get("opposition", "")
+    if opposition:
+        lines.append(f"\nConceptual opposition:")
+        lines.append(f"  {opposition}")
+
+    notes = chapter_data.get("writing_notes", "")
+    if notes:
+        lines.append(f"\nWriting notes:")
+        lines.append(f"  {notes}")
+
+    return "\n".join(lines)
+
+
+def print_bank(bank: dict, chapter_filter: int = None):
+    print(f"\n{'═' * 60}")
+    print(f"  RESEARCH BANK — {bank.get('book_title', 'Unknown Book')}")
+    print(f"{'═' * 60}")
+
+    global_anchors = bank.get("global_anchors", [])
+    if global_anchors:
+        print(f"\nGLOBAL ANCHORS (whole manuscript):")
+        for a in global_anchors:
+            print(f"  • {a}")
+
+    chapters = bank.get("chapters", {})
+    for key, data in sorted(chapters.items(), key=lambda x: int(x[0]) if x[0].isdigit() else 0):
+        if chapter_filter and int(key) != chapter_filter:
+            continue
+        print(format_chapter_bank(key, data))
+
+    print(f"\n{'═' * 60}")
+    print(f"  Chapters in bank: {len(chapters)}")
+    print()
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("bank_file")
+    parser.add_argument("--chapter", type=int, help="Show specific chapter only")
+    parser.add_argument("--validate", action="store_true")
+    parser.add_argument("--markdown", action="store_true")
+    parser.add_argument("--json", action="store_true")
+    args = parser.parse_args()
+
+    path = Path(args.bank_file)
+    if not path.exists():
+        print(f"Error: File not found: {args.bank_file}", file=sys.stderr)
+        sys.exit(1)
+
+    bank = json.loads(path.read_text(encoding="utf-8"))
+
+    if args.validate:
+        result = validate_bank(bank)
+        if result["clean"]:
+            print(f"\n  ✓ Research bank is clean — {len(bank.get('chapters', {}))} chapters validated\n")
+        else:
+            print(f"\n  ✗ {result['total_issues']} issue(s) found:\n")
+            for issue in result["issues"]:
+                print(f"  Ch.{issue['chapter']} [{issue['type']}]: {issue['content']}")
+                for i in issue["issues"]:
+                    print(f"    → {i}")
+            print()
+    elif args.json:
+        print(json.dumps(bank, indent=2))
+    else:
+        print_bank(bank, args.chapter)