Clarion Living Letter Update
Update the annual investor letter at ~/clarion/letters/{YEAR}-letter.md with a new quarterly section, or finalize it at year-end. Auto-fills the system-deterministic parts (regime snapshot, thesis health table, portfolio bucket positions from active theses); marks the narrative-heavy parts (What We Did, What We Learned, Year in Context, Mistakes & Lessons, Looking Ahead) as [TODO] for the user to write with chat assistance. Append-only — refuses to overwrite an already-populated quarter without --force. Use when the user asks "update the letter", "quarterly letter update", "finalize the letter
Install
npx skills add zocomputer/skills --skill clarion-living-letter-updategit clone --depth 1 https://github.com/zocomputer/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/External/clarion-living-letter-update ~/.claude/skills/clarion-living-letter-updatePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Clarion living-letter update
The annual investor letter is the system's self-accountability tool — a real-time, timestamped record of how the system thought, what it did, and what it learned. Per [`docs/PRINCIPLES.md` Principle 10 (Compound Knowledge, Not Just Capital)](../../docs/PRINCIPLES.md#10-compound-knowledge-not-just-capital), it's where the institutional memory accrues.
This skill scaffolds quarterly entries and the year-end finalization. The system fills in regime + thesis health automatically; the human writes the narrative.
## When to use
User says any of:
- "Update the letter."
- "Quarterly letter update."
- "Write the Q2 entry."
- "Finalize the {YEAR} letter."
Cadence:
- **Quarterly (minimum)** — at the end of each quarter, run `update`. The script writes the structured sections; the user fills the narrative.
- **Year-end** — after Q4 is filled in, run `finalize` to add the Year in Context intro and the Full Year Summary scaffold.
## Decision tree
1. **Pick the operation:**
- `update` (default) — append the current quarter's section
- `finalize` — year-end Year in Context + Full Year Summary
- `status` — show what's already in the letter
2. **Run the script.**
```bash
python /home/workspace/clarion-intelligence-system/skills/clarion-living-letter-update/scripts/letter.py update
python ... letter.py update --quarter 2 --year 2026
python ... letter.py finalize --year 2026
python ... letter.py status --year 2026
```Details
- Skill name
clarion-living-letter-update- Repository
- zocomputer/skills
- Path
External/clarion-living-letter-update/SKILL.md- License
- MIT
- Repo updated
- 29 July 2026
FAQ
What does the Clarion Living Letter Update skill do?
Update the annual investor letter at ~/clarion/letters/{YEAR}-letter.md with a new quarterly section, or finalize it at year-end. Auto-fills the system-deterministic parts (regime snapshot, thesis health table, portfolio bucket positions from active theses); marks the narrative-heavy parts (What We Did, What We Learned, Year in Context, Mistakes & Lessons, Looking Ahead) as [TODO] for the user to write with chat assistance. Append-only — refuses to overwrite an already-populated quarter without --force. Use when the user asks "update the letter", "quarterly letter update", "finalize the letter
How do I install the Clarion Living Letter Update skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add zocomputer/skills --skill clarion-living-letter-update. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Clarion Living Letter Update popular?
It lives in zocomputer/skills, which has 46 GitHub stars and 56 forks.
Related skills
Add Flashcards
46zocomputer/skills
Converts webpages, articles, or documents into study flashcards that you can review with spaced repetition
Blog Site
46zocomputer/skills
Build a blog or newsletter to share your thoughts.
Blogwatcher
46zocomputer/skills
Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
Clarion Portfolio Monitor
46zocomputer/skills
Fetch live portfolio positions, balances, and daily transactions from TastyTrade. Outputs a structured JSON snapshot and a human-readable summary to ~/clarion/portfolio/. Use when the user asks for portfolio status, net liquidation value (NLV), position P/L, daily fills, or needs current holdings for the investor letter or thesis monitoring. Requires TastyTrade OAuth credentials (client secret + refresh token) stored as Zo secrets.
Clarion Expected Return Calc
46zocomputer/skills
Compute the equity-vs-T-bill allocation for the Value bucket (50% of portfolio). Implements the Expected-Return Framework — looks up the historical 10-year forward return from the S&P 500 Shiller CAPE, computes the regime-adjusted hurdle (rf + regime premium), and produces a 5-tier verdict (STRONG EQUITY / LEAN EQUITY / NEUTRAL / LEAN T-BILLS / MAXIMUM T-BILLS) with recommended Value-bucket equity/T-bill split. Use when the user asks "should I be in stocks or bonds right now?", "what's the equity hurdle?", "is the market overvalued?", "what's the right Value bucket allocation?", or before addi
Clarion Setup
46zocomputer/skills
Bootstraps the Clarion Intelligence System on Zo Computer. Run this once after installing — clones the source repo, installs the ai_buffett_zo Python library, creates the workspace data tree under /home/workspace/clarion/ (auto-detected on Zo), auto-installs all ten sibling clarion-* skills (regime-check, sec-research, single-stock-eval, expected-return-calc, value-screener, thesis-write, thesis-monitor, watchlist-update, living-letter-update, portfolio-monitor) under /home/workspace/Skills/, and registers the sec-indexer background service. Idempotent (safe to re-run). The only manual step is
Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.