aphorisms

name	Aphorisms
description	Curated aphorism collection with CRUD — content-based matching, themed search, thinker research, DB maintenance. Quotes organized by author/theme/context/usage to prevent repetition. Four workflows: FindAphorism, AddAphorism, ResearchThinker, SearchAphorisms. Themes: Stoicism, Wisdom, Truth-seeking, Excellence, Resilience, Curiosity. USE WHEN aphorism, quote, find a quote, research thinker, add aphorism, quote for newsletter, what did X say about, quote bank. NOT FOR creative writing or social posts.
effort	low

Customization

Before executing, check for user customizations at: ~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/Aphorisms/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)

You MUST send this notification BEFORE doing anything else when this skill is invoked.

1. Send voice notification:

   curl -s -X POST http://localhost:31337/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow in the Aphorisms skill to ACTION"}' \
     > /dev/null 2>&1 &
   

2. Output text notification:

   Running the **WorkflowName** workflow in the **Aphorisms** skill to ACTION...
   

This is not optional. Execute this curl command immediately upon skill invocation.

Aphorisms

What It Does

Manages a curated aphorism collection with full CRUD. Matches quotes to content by theme, searches by theme or keyword, researches a thinker's body of work, and tracks usage so the same quote doesn't get reused. Four workflows: FindAphorism, AddAphorism, ResearchThinker, SearchAphorisms.

The Problem

Good writing wants a sharp quote at the open or close, but finding the right one under deadline means either reaching for the same worn lines every time or trawling the web and landing on misattributed junk. A flat quote dump doesn't help — you need quotes organized by theme and tagged with where they've already been used, so the match is fast and you never repeat yourself. This skill is that organized, deduplicated, attribution-checked store.

How It Works

The collection is organized by author, theme, context, and usage history. Matching reads the content's themes and tone, searches the store for thematic fits, filters out recently used quotes, and returns ranked options with a reason for each. Adding a quote parses the text and author, assigns themes, records context and source, and updates the theme index. Thinker research pulls relevant quotes from a philosopher's work and files them by theme with sources.

Workflow Routing

When executing a workflow, output this notification directly:

Running the **WorkflowName** workflow in the **Aphorisms** skill to ACTION...

Workflow	Trigger	File
FindAphorism	Find aphorism, quote for newsletter, match aphorism, suggest quote, aphorism recommendation	Workflows/FindAphorism.md
AddAphorism	Add quote, add aphorism, save quote, new aphorism, store quote	Workflows/AddAphorism.md
ResearchThinker	Research thinker, find quotes from, what did X say, thinker quotes on	Workflows/ResearchThinker.md
SearchAphorisms	Search aphorisms, find quotes on, quotes about, quotes matching, what aphorisms	Workflows/SearchAphorisms.md

---

When to Activate This Skill

Direct Aphorism Requests

• "find aphorism", "find a quote", "find quote for X"
• "search aphorisms", "search quotes", "look up quote"
• "what aphorism", "which quote", "perfect quote for"
• "suggest aphorism", "recommend quote", "match quote to"
• "aphorism for newsletter", "quote for blog post", "quote for article"

Database Management

• "add aphorism", "add quote", "save this quote"
• "new aphorism", "include quote", "store this"
• "update aphorism database", "manage quotes"

Research & Discovery

• "research [thinker] quotes", "find [author] aphorisms"
• "what did [philosopher] say about", "quotes from [thinker]"
• "Hitchens quotes", "Feynman wisdom", "Spinoza aphorisms"
• "Sam Harris on [topic]", "David Deutsch quotes"

Theme-Based Search

• "aphorisms about [theme]", "quotes on [topic]"
• "show quotes about resilience", "wisdom on learning"
• "stoic quotes", "quotes matching [keyword]"

Newsletter Workflow Integration

• User working on newsletter and needs aphorism
• Mentions "newsletter" + "quote" or "aphorism"
• Content analysis for quote matching
• Avoiding previously used quotes

Use Case Indicators

• Need wisdom quote to open/close newsletter
• Want thematically relevant aphorism
• Building quote collection
• Researching philosopher's ideas
• Managing aphorism library

---

Core Capabilities

1. Intelligent Quote Matching

Analyze newsletter or article content to find the perfect thematic aphorism:

• Extract key themes from content
• Match themes to aphorism database
• Consider tone and style alignment
• Avoid recently used quotes
• Provide multiple options with rationale

2. Comprehensive Database

Curated collection organized by:

• Author - Thinkers aligned with TELOS philosophy
• Theme - Categories like resilience, learning, stoicism, risk, progress
• Context - Background on quote origin and meaning
• Usage History - Track which quotes used in which newsletters

3. Thinker Research

Deep research on key philosophers:

• Christopher Hitchens - Rationality, skepticism, intellectual honesty
• David Deutsch - Knowledge creation, optimism, explanations
• Sam Harris - Rationality, meditation, free will, morality
• Baruch Spinoza - Ethics, reason, freedom, nature
• Richard Feynman - Curiosity, scientific thinking, doubt, clarity

4. Theme-Based Organization

Aphorisms categorized by themes matching user content:

• Work Ethic & Excellence - Craft, mastery, high standards
• Resilience & Strength - Adversity, persistence, growth
• Learning & Education - Curiosity, continuous improvement
• Stoicism & Control - Internal locus, acceptance, discipline
• Risk & Action - Courage, failure, experimentation
• Wisdom & Truth - Rationality, evidence, honest inquiry

---

Database Structure

Location: ~/.claude/skills/Aphorisms/Database/aphorisms.md

Current Collections:

1. Initial Collection - 15 curated quotes covering core themes
2. Thinkers Aligned with TELOS - Sections for Hitchens, Deutsch, Harris, Spinoza, Feynman (to be populated)
3. Theme Index - Quick reference by category
4. Newsletter Usage History - Tracking to avoid repetition

Metadata Per Aphorism:

• Full quote text
• Author attribution
• Theme tags
• Context and background
• Source reference (when available)

---

Available Workflows

Quote Discovery & Matching

FindAphorism.md - Intelligent newsletter content analysis

• Analyze content themes and tone
• Search database for thematic matches
• Consider usage history
• Provide top 3-5 recommendations with rationale
• Include quote, author, and why it fits

Database Management

AddAphorism.md - Structured quote addition

• Accept quote text and author
• Extract or assign themes
• Add context and background
• Update theme index
• Validate uniqueness

Research Operations

ResearchThinker.md - Deep thinker research

• Research specific philosopher's relevant quotes
• Focus on TELOS-aligned themes
• Add quotes to appropriate database section
• Include context and sources
• Update theme index

Search & Discovery

SearchAphorisms.md - Theme and keyword search

• Search by theme, keyword, or author
• Return matching aphorisms
• Sort by relevance or usage
• Provide context for each result

---

Integration Points

Newsletter Content Skill

• Automatic aphorism suggestions when creating newsletter
• Theme analysis from newsletter content
• Usage tracking for variety

Research Skill

• Deep thinker research capabilities
• Web research for quote verification
• Source attribution and context

Writing Skill

• Blog post quote recommendations
• Story explanation enhancement
• Content opening/closing quotes

---

Key Thinkers & Philosophy Alignment

Why These Thinkers?

All five thinkers align with TELOS themes of wisdom, rationality, truth-seeking, and human flourishing:

Christopher Hitchens

• Intellectual honesty and skepticism
• Question everything, follow evidence
• "What can be asserted without evidence can be dismissed without evidence"

David Deutsch

• Optimistic epistemology - problems are solvable
• Knowledge creation through criticism
• Emphasis on explanations, not just predictions

Sam Harris

• Scientific rationality applied to ethics
• Importance of reason and evidence
• Mindfulness and self-awareness

Baruch Spinoza

• Ethics based on reason
• Freedom through understanding
• Reality acceptance and wisdom

Richard Feynman

• Curiosity-driven learning
• Doubt as a tool for knowledge
• Clarity of thought and explanation
• Scientific honesty

Research Priority

1. Immediate: Analyze previous newsletters for aphorism patterns
2. Phase 1: Research Hitchens and Feynman (most quotable, clear style)
3. Phase 2: Research Harris and Deutsch (contemporary, relevant)
4. Phase 3: Research Spinoza (historical, philosophical depth)

---

Examples

Example 1: Finding Aphorism for Newsletter

User: "I'm writing a newsletter about overcoming setbacks in AI research. Find me a good aphorism."

Skill Response:

1. Analyze themes: resilience, adversity, persistence, progress
2. Search database for matching themes
3. Recommend top 3 options:
   • Rocky Balboa quote (direct, powerful on getting hit and moving forward)
   • Bob Marley quote (strength through necessity)
   • Marcus Aurelius quote (stoic control focus)
4. Provide rationale for each

Example 2: Adding New Quote

User: "Add this quote: 'The cure for boredom is curiosity. There is no cure for curiosity.' - Dorothy Parker"

Skill Response:

1. Parse quote and author
2. Identify themes: curiosity, learning, passion
3. Add to database with context
4. Update theme index
5. Confirm addition

Example 3: Researching Thinker

User: "Research David Deutsch quotes about knowledge and optimism"

Skill Response:

1. Research Deutsch's works (The Beginning of Infinity, The Fabric of Reality)
2. Extract relevant quotes on knowledge creation and optimism
3. Add to database with source attribution
4. Organize by theme
5. Report findings

Example 4: Theme Search

User: "Show me all aphorisms about learning and education"

Skill Response:

1. Search database for learning/education theme
2. Return matching quotes:
   • Gandhi (live/learn)
   • Krishnamurti (lifelong learning)
   • Confucius (learning + thinking)
   • Aaron Swartz (curiosity)
3. Provide context for each

---

Best Practices

Quote Selection for Newsletter

1. Avoid repetition - Check usage history before reusing

Database Maintenance

1. Verify accuracy - Check quote text and attribution
2. Track usage - Update history to avoid overuse

Thinker Research

1. Primary sources - Prefer direct quotes from books/speeches
2. Avoid misattribution - Verify quote authenticity
3. TELOS alignment - Focus on wisdom, rationality, truth-seeking

---

Future Enhancements

Planned Features

1. Automatic theme detection - ML-based content analysis
2. Quote recommendation engine - Collaborative filtering based on past selections
3. Integration with previous newsletters - Analyze historical aphorism usage patterns
4. Expanded thinker research - Add more philosophers aligned with TELOS
5. Mood/tone matching - Match quote emotional tone to content
6. Quote formatting - Auto-format for newsletter style

Long-term Vision

• Comprehensive wisdom library covering all content needs
• Predictive recommendations based on newsletter draft
• Historical analysis of most impactful quotes
• Community contributions (vetted)
• Integration with other writing workflows

---

Quick Reference

Most Used Commands:

• "Find aphorism for this newsletter" → Analyze content and recommend
• "Add this quote" → Add to database with metadata
• "Research [thinker] quotes" → Deep research and database population
• "Search aphorisms about [theme]" → Theme-based search

Database Location: ~/.claude/skills/Aphorisms/Database/aphorisms.md

Current Collection Size:

• 15 initial quotes (initial collection)
• 5 thinker sections (to be populated)
• 12+ theme categories

Key Thinkers: Hitchens, Deutsch, Harris, Spinoza, Feynman

---

Related Skills

_NEWSLETTER - Newsletter creation and content suggestions Research - Web research and content analysis _WRITING - Content auditing and AI-pattern cleanup _PERSONAL - User's philosophy and values context

---

Last Updated: 2025-11-20

Gotchas

• Search by theme, not exact text. The collection is organized by conceptual themes, not keyword matching.
• Always include attribution and source when adding new aphorisms. Unattributed quotes are useless.
• Duplicate detection: Check if the aphorism already exists before adding. Same idea, different wording, still counts as duplicate.

Execution Log

After completing any workflow, append a single JSONL entry:

echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","skill":"Aphorisms","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/LIFEOS/MEMORY/SKILLS/execution.jsonl

Replace WORKFLOW_USED with the workflow executed, 8_WORD_SUMMARY with a brief input description, and SECONDS with approximate wall-clock time. Log status: "error" if the workflow failed.