New to Claude Skills? Learn how to install them →

danielmiessler on GitHub

Aphorisms

Free

Curated aphorism collection with advanced search capabilities.

Get this skill

Free · Opens the source repo

What Aphorisms does

The Aphorisms skill provides a comprehensive database of curated aphorisms, allowing users to find, add, and research quotes efficiently. It organizes quotes by themes, authors, and contexts, ensuring that users can retrieve relevant quotes without repetition. The skill supports full CRUD operations, meaning users can create, read, update, and delete aphorisms, making it a versatile tool for anyone needing a reliable source of quotes.

With four dedicated workflows—FindAphorism, AddAphorism, ResearchThinker, and SearchAphorisms—users can easily navigate the database to find quotes that align with specific themes such as Stoicism, Wisdom, and Curiosity. Each workflow is designed to streamline the process of quote retrieval and management, providing a ranked list of quotes that match user-defined criteria. This is particularly useful for educators, writers, and content creators who need to reference or incorporate quotes into their work.

The skill also emphasizes the importance of attribution and source referencing, ensuring that all quotes added to the database are properly credited. This feature not only enhances the credibility of the quotes but also aids in maintaining a high-quality collection. The database is structured to prevent duplicates, allowing users to build a unique repository of aphorisms over time.

Overall, the Aphorisms skill serves as a valuable resource for anyone interested in wisdom literature, providing a structured approach to exploring and utilizing aphorisms in various contexts, from academic research to personal reflection.

When to use it

Use this skill when you need to find or add aphorisms for presentations, newsletters, or personal reflection.

When not to use it

This skill is not suitable for creative writing or generating social media posts that require original content.

What you can build with it

Finding Quotes for a Newsletter

Use the FindAphorism workflow to quickly locate relevant quotes that can enhance your newsletter content.

Researching a Thinker

The ResearchThinker workflow allows you to gather quotes from specific thinkers, making it easier to compile their insights.

Adding New Aphorisms

Utilize the AddAphorism workflow to contribute new quotes to the database while ensuring proper attribution.

How to install Aphorisms

View source

1. Install with the skills CLI

npx skills add danielmiessler/lifeos/Aphorisms --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by danielmiessler

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...
WorkflowTriggerFile
FindAphorismFind aphorism, quote for newsletter, match aphorism, suggest quote, aphorism recommendationWorkflows/FindAphorism.md
AddAphorismAdd quote, add aphorism, save quote, new aphorism, store quoteWorkflows/AddAphorism.md
ResearchThinkerResearch thinker, find quotes from, what did X say, thinker quotes onWorkflows/ResearchThinker.md
SearchAphorismsSearch aphorisms, find quotes on, quotes about, quotes matching, what aphorismsWorkflows/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.

Frequently asked questions about Aphorisms

Similar skills