distill-theme

Aggregate theme-tagged Thesis and Observation blocks into a theme-level snapshot.

4|Updated May 5, 2026
One-click install
npx skills add https://github.com/mthli/skills --skill distill-theme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: distill-theme
Source: https://github.com/mthli/skills/tree/main/distill-theme
Command: npx skills add https://github.com/mthli/skills --skill distill-theme

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

distill-theme turns scattered, per-ticker investment journal entries into a single, readable snapshot of your overall stance on a specific theme.

Core Features & Use Cases

  • Cross-ticker aggregation: Consolidates every Thesis and Observation tagged with a target theme from positions/*.md into a theme-level view.
  • Regime-aware context: Pulls relevant Macro context from macro.md via RELATED_THEMES to frame the theme’s backdrop.
  • Snapshot outputs for fast review: Writes to .claude/snapshots/themes/<theme>.md so future discussions can load the consensus without re-reading all journals.
  • Designed to be explicitly invoked: Does not auto-trigger; it only runs when the user requests a distillation for a specific theme.
  • Curreny and fallback logic: Leverages existing per-ticker snapshots when current, otherwise derives the latest stance from the journal data.

Quick Start

Use the distill-theme skill to refresh the snapshot for a specific theme after the user explicitly requests it, producing .claude/snapshots/themes/<theme>.md for use in the next cross-ticker theme discussion.

Frequently Asked Questions about distill-theme

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I aggregate cross-ticker investment journal entries into a single theme snapshot?

You can aggregate cross-ticker investment journal entries into a single theme snapshot by consolidating Thesis and Observation blocks tagged with a target theme from positions/*.md files into a unified, readable summary.

What is theme distillation for cross-ticker portfolio review?

Theme distillation for cross-ticker portfolio review is the process of consolidating per-ticker investment journal entries and macro context into a single snapshot expressing your overall stance on a specific theme.

How do I pull macro context into my investment thesis snapshots?

You pull macro context into your investment thesis snapshots by leveraging RELATED_THEMES tags to extract relevant regime-aware backdrop information from macro.md, framing the cross-ticker theme analysis.

Do I need to pre-register tags before generating a cross-ticker theme snapshot?

Yes, you need to pre-register tags before generating a cross-ticker theme snapshot via validated entries in .claude/THEMES.md, requiring exact comma-token tag matching for THEMES and RELATED_THEMES.

Does the theme snapshot generation run automatically when I update my investment journals?

No, theme snapshot generation does not run automatically when you update your investment journals; it is designed for explicit invocation only and writes guarded snapshots after user approval.

Where does the cross-ticker theme snapshot get saved for future portfolio discussions?

The cross-ticker theme snapshot gets saved to .claude/snapshots/themes/<theme>.md, allowing future portfolio discussions to load the consensus view without re-reading all individual journal entries.