Aphorisms skill

Curated aphorism collection with CRUD — content-based matching, themed search, thinker research, DB maintenance.

by danielmiessler·MIT license·★ 19,269 Stars on the repo·GitHub ↗

Use now

Files of Aphorisms

danielmiessler/main1 file shown
SKILL.md
Show the full text85 lines

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

Curated aphorism store with full CRUD. Deliverable: a ranked, non-repeated, attributed quote matched to the content's themes — with a one-line reason per option. Adding parses text + author, assigns themes, records source, and dedupes. Research pulls a thinker's TELOS-aligned quotes 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

Database

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

Organized by author, theme, context, and usage history. Per-aphorism metadata: full quote text, author attribution, theme tags, context/background, source reference. Sections: Initial Collection, per-thinker sections, Theme Index, Newsletter Usage History.

Taxonomy (curated state)

Themes: Work Ethic & Excellence · Resilience & Strength · Learning & Education · Stoicism & Control · Risk & Action · Wisdom & Truth.

TELOS-aligned thinkers (wisdom, rationality, truth-seeking, human flourishing):

  • Christopher Hitchens — intellectual honesty, skepticism, follow the evidence
  • David Deutsch — optimistic epistemology, knowledge creation, explanations over predictions
  • Sam Harris — scientific rationality applied to ethics, reason, mindfulness
  • Baruch Spinoza — ethics from reason, freedom through understanding, acceptance
  • Richard Feynman — curiosity, doubt as a tool, clarity, scientific honesty

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.

1---
2name: Aphorisms
3version: 1.1.20
4description: "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."
5---
6 
7## Customization
8 
9**Before executing, check for user customizations at:**
10`~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/Aphorisms/`
11 
12If 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.
13 
14 
15## 🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)
16 
17**You MUST send this notification BEFORE doing anything else when this skill is invoked.**
18 
191. **Send voice notification**:
20 ```bash
21 curl -s -X POST http://localhost:31337/notify \
22 -H "Content-Type: application/json" \
23 -d '{"message": "Running the WORKFLOWNAME workflow in the Aphorisms skill to ACTION"}' \
24 > /dev/null 2>&1 &
25 ```
26 
272. **Output text notification**:
28 ```
29 Running the **WorkflowName** workflow in the **Aphorisms** skill to ACTION...
30 ```
31 
32**This is not optional. Execute this curl command immediately upon skill invocation.**
33 
34# Aphorisms
35 
36Curated aphorism store with full CRUD. **Deliverable: a ranked, non-repeated, attributed quote matched to the content's themes** — with a one-line reason per option. Adding parses text + author, assigns themes, records source, and dedupes. Research pulls a thinker's TELOS-aligned quotes and files them by theme with sources.
37 
38## Workflow Routing
39 
40**When executing a workflow, output this notification directly:**
41 
42```
43Running the **WorkflowName** workflow in the **Aphorisms** skill to ACTION...
44```
45 
46| Workflow | Trigger | File |
47|----------|---------|------|
48| FindAphorism | Find aphorism, quote for newsletter, match aphorism, suggest quote, aphorism recommendation | `Workflows/FindAphorism.md` |
49| AddAphorism | Add quote, add aphorism, save quote, new aphorism, store quote | `Workflows/AddAphorism.md` |
50| ResearchThinker | Research thinker, find quotes from, what did X say, thinker quotes on | `Workflows/ResearchThinker.md` |
51| SearchAphorisms | Search aphorisms, find quotes on, quotes about, quotes matching, what aphorisms | `Workflows/SearchAphorisms.md` |
52 
53## Database
54 
55**Location:** `~/.claude/skills/Aphorisms/Database/aphorisms.md`
56 
57Organized by author, theme, context, and usage history. Per-aphorism metadata: full quote text, author attribution, theme tags, context/background, source reference. Sections: Initial Collection, per-thinker sections, Theme Index, Newsletter Usage History.
58 
59## Taxonomy (curated state)
60 
61**Themes:** Work Ethic & Excellence · Resilience & Strength · Learning & Education · Stoicism & Control · Risk & Action · Wisdom & Truth.
62 
63**TELOS-aligned thinkers** (wisdom, rationality, truth-seeking, human flourishing):
64- **Christopher Hitchens** — intellectual honesty, skepticism, follow the evidence
65- **David Deutsch** — optimistic epistemology, knowledge creation, explanations over predictions
66- **Sam Harris** — scientific rationality applied to ethics, reason, mindfulness
67- **Baruch Spinoza** — ethics from reason, freedom through understanding, acceptance
68- **Richard Feynman** — curiosity, doubt as a tool, clarity, scientific honesty
69 
70## Gotchas
71 
72- **Search by theme, not exact text.** The collection is organized by conceptual themes, not keyword matching.
73- **Always include attribution and source when adding new aphorisms.** Unattributed quotes are useless.
74- **Duplicate detection:** Check if the aphorism already exists before adding. Same idea, different wording, still counts as duplicate.
75 
76## Execution Log
77 
78After completing any workflow, append a single JSONL entry:
79 
80```bash
81echo '{"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
82```
83 
84Replace `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.
85 

Discussion

Alternatives

Influence and negotiationInfluence and negotiation toolkit for any interaction needing another person's agreement, even when the user never says 'negotiation'. Covers B2B sales, salary reviews and raise asks, collective bargaining and unions, hard 1:1s, recruitment closes, cross-cultural deals, mediation, and diplomatic messages — declining, pushing back on scope, justifying a delay, raising a concern, getting alignment. Use when the user says 'they just said X, what do I say' or 'draft a reply', or mentions a buyer, champion, procurement, RFP, sponsor, HR, union, or candidate, or a pushback, refusal, ghosting, no-decision, escalation, fixed budget, counter-offer, comp band, strike, BATNA, anchor, or concession.Sales & ecommerce · MITSales materials that help you close dealsTell us what you sell and who buys it; get back a pitch outline, a one-page leave-behind, and ready answers to the objections you hear most.Business & ops · MITSales automatorSales automation and outreach specialist. Use PROACTIVELY for cold email campaigns, follow-up sequences, proposal templates, case studies, sales scripts, and conversion optimization. Specifically:\n\n<example>\nContext: A founder wants a cold outreach sequence for a new B2B SaaS product targeting operations managers.\nuser: "Write me a 4-email cold sequence to reach operations managers at mid-size logistics companies."\nassistant: "I'll first ask for the value proposition, target ICP details, and how the contact list was sourced (opt-in, public directory, or purchased). Then I'll draft a 4-touchpoint sequence that leads with value, includes required CAN-SPAM elements (sender identity, physical address, working unsubscribe), and flags any personalization facts pulled from research with their source."\n<commentary>\nUse sales-automator for cold email/follow-up copy, but only after confirming ICP, value prop, and list provenance, and only with compliance elements built in.\n</commentary>\n</example>\n\n<example>\nContext: A sales rep wants case studies to include in a proposal template.\nuser: "Add some case studies and social proof to this proposal — say we've helped companies cut costs by 30%."\nassistant: "I can include case studies only using real customer names/results you provide. If you don't have a confirmed example yet, I'll use a clearly marked placeholder (e.g., '[Customer Name — pending confirmed results]') rather than inventing a company, quote, or percentage."\n<commentary>\nUse sales-automator for proposal/case-study drafting, but never fabricate customer names, quotes, or statistics — placeholders only until the user supplies real data.\n</commentary>\n</example>\n\n<example>\nContext: A prospect asks a deep technical integration question mid-sequence.\nuser: "The prospect wants to know if our API supports batch webhook retries before they'll take a call."\nassistant: "That's a technical capability question best answered by sales-engineer, who can validate it against the actual product. I can draft the outreach copy and scheduling logic around their answer once you have it."\n<commentary>\nsales-automator handles outreach copy and cadences, not product/technical validation — hand off technical questions to sales-engineer.\n</commentary>\n</example>\n\nDoes not build CRM/outbound sending infrastructure or Salesforce automation — hand off to salesforce-expert or sales-engineer for that. Does not draft jurisdiction-specific compliance/legal language — hand off to legal-advisor.Sales & ecommerce · MITBusiness & Growth Skills — RouterRouter/index for the 4 business & growth skills bundled in this plugin: customer-success-manager (health scoring, churn risk, expansion), sales-engineer (RFP analysis, competitive matrices, PoC planning), revenue-operations (pipeline, forecast accuracy, GTM efficiency), and contract-and-proposal-writer. Use when a growth/revenue request doesn't obviously match one skill and you need to pick the right one (e.g., 'which accounts are at risk', 'should we bid on this RFP').Sales & ecommerce · MIT