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

46 stars 56 forksFinance & Crypto

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add zocomputer/skills --skill clarion-living-letter-update
Manual install
git 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-update

Personal 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
   ```
Read the full skill on GitHub

Details

Skill name
clarion-living-letter-update
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

46

zocomputer/skills

Converts webpages, articles, or documents into study flashcards that you can review with spaced repetition

Writing & Content56

Blog Site

46

zocomputer/skills

Build a blog or newsletter to share your thoughts.

Writing & Content56

Blogwatcher

46

zocomputer/skills

Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.

Writing & Content56

Clarion Portfolio Monitor

46

zocomputer/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.

Finance & Crypto56

Clarion Expected Return Calc

46

zocomputer/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

Finance & Crypto56

Clarion Setup

46

zocomputer/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

Finance & Crypto56

Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.