Agent skill

Investment Thesis Tracker

by HKUDS in HKUDS/Vibe-Trading

Keeps a written investment thesis for each stock you hold and re-checks it every quarter against new earnings, scoring its health and recommending hold, add, trim or exit.

MITAuto-check passedBusiness, Finance & HR

Install Investment Thesis Tracker

skills CLI
$ npx skills add HKUDS/Vibe-Trading --skill thesis-tracker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HKUDS/Vibe-Trading thesis-tracker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent/src/skills/thesis-tracker .claude/skills/thesis-tracker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
thesis-tracker
GitHub stars
35k
Token cost
~2.2k tokens
SKILL.md length
956 words
Files
1
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

Keeps a written investment thesis for each stock you hold and re-checks it every quarter against new earnings, scoring its health and recommending hold, add, trim or exit.

  • Writing an investment thesis right after buying a stock
  • SKILL.md covers Design Philosophy, Step 1: Decide the Mode, Mode A: Build the Investment… and Mode B: Tracking Check, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Re-checking a holding's thesis each earnings season

What it does

The skill addresses a common gap: without written sell conditions, investors hold too long, panic-sell on dips, or forget why they bought in the first place. Following Buffett and Li Lu, it writes the sell conditions before the first quarterly check. Whether a thesis file already exists for the company decides the mode automatically, build for the first use or quarterly track for later ones, though a company name can also force a rebuild or a direct quarterly check.

Build mode starts with a web search for the current price, valuation and latest financials, reads any existing research report, and runs valuation and market-cap verification tools before writing anything. The core thesis has to fit five one-sentence answers in 200 words or fewer, covering what the business does, how it makes money, and its moat, among others, and if those five sentences cannot be filled in, the buy decision itself is judged too unclear. The thesis then breaks into three to seven verifiable assumptions, each with a check method and a frequency, plus red-line conditions whose triggering forces a re-evaluation of the whole position.

When your agent uses it

  • Writing an investment thesis right after buying a stock
  • Re-checking a holding's thesis each earnings season
  • Deciding whether to hold, add, trim or exit a position
  • Working out why a stock was bought in the first place

Example prompts

  • “I just bought this stock. Build the investment thesis for it.”
  • “Run the quarterly check on my thesis against the latest earnings.”
  • “Force a rebuild of the thesis for this position.”

Requirements

  • Web search access for current price and financial data
  • A valuation and market-cap verification tool

What it can do on your machine

Read from SKILL.md and the folder at commit 14cabaf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Investment Thesis Tracker loads about 2.2k tokens when it runs. Until then it costs about 129 tokens; SKILL.md has 956 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~129
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HKUDS/Vibe-Trading at commit 14cabaf, republished under its MIT licence (© HKUDS). 956 words, ~2,154 tokens.

Download SKILL.mdSave it as .claude/skills/thesis-tracker/SKILL.md (or your agent's skills folder).
name
thesis-tracker
description
Buy-side discipline system. For each holding, maintain a written investment thesis — core thesis in 5 sentences, falsifiable assumptions, red lines, valuation anchors — and re-check it each quarter against new earnings/events. Scores thesis health 1-10 from assumption breakage and red-line triggers, and recommends hold / add / trim / exit. Use it right after buying a stock (to write the thesis) and every earnings season (to check it). Bridges the research→buy→monitor gap that most investors skip.
category
strategy

Investment Thesis Tracker: Post-Buy Discipline

Track an investment thesis for a holding. First use on a company → build the thesis; later uses → quarterly check.

Supported input: company name (auto-decide build vs track); company build (force rebuild); company quarterly check (against latest earnings).

"Buying is only the beginning. The real work is continuous tracking through the holding period." — Li Lu

"When the facts change, I change my mind. What do you do, sir?" — Keynes

Design Philosophy

Most investors' process is: research → buy → pray. Without systematic post-buy tracking, they: refuse to sell when they should ("wait, it'll come back"); panic-sell when they shouldn't ("down 20%, was I wrong?"); forget why they bought ("why did I buy this again?").

Buffett and Li Lu write down sell conditions before buying, then check the thesis each quarter.

Step 1: Decide the Mode

Check whether a thesis file already exists (use read_file on reports/{company}-thesis.md): not found → Build (Mode A); found → Track (Mode B).


Mode A: Build the Investment Thesis

A0: Data Collection

Use web_search to get the current price, valuation (PE/PB/dividend yield), and latest financials. If a research report exists, read_file it first. Use financial_rigor (command=verify_valuation) to verify valuation, financial_rigor (command=verify_market_cap) to sanity-check market cap.

A1: Core Thesis (must be writable in ≤200 words)

The thesis must answer 5 questions, one sentence each:

I bought {Company} at {price} because:
1. The essence of this business is ___, and I understand how it makes money.
2. Its moat is ___, and it's widening / stable.
3. Management is ___, trustworthy because ___.
4. The current price is a {discount}% to intrinsic value; the margin of safety comes from ___.
5. Even if I'm wrong, downside is contained because ___.

If you can't fill 5 sentences, the thesis itself is flawed — the buy decision isn't clear enough.

A2: Core Assumptions List

Break the thesis into verifiable assumptions (3-7 typically; too few = shallow thinking, too many = unfocused):

#Core AssumptionHow to verifyFrequencyStatus
1e.g. revenue growth stays >15%Quarterly revenue growthQuarterly🟢 Holding
2e.g. gross margin stable >60%Quarterly gross marginQuarterly🟢 Holding
A3: Red Lines (triggering any one = must re-evaluate)
#Red-line conditionSeverityAction on trigger
1Management integrity problem (fraud, related-party)FatalExit immediately
2Core business revenue down 2 consecutive quartersSevereTrim 50%, re-evaluate
3Moat explicitly breached (competitor reaches parity)SevereDeep research, consider exit
4Regulatory change fundamentally alters the business modelSevereRe-value intrinsic value
5Management large unplanned disposalWarningInvestigate
6Macro trend reversal for this name's end-market — e.g. demographic clock (population decline) for consumer/property/education names; consumption downgrade (居民边际消费下降); generational shift away from the categorySevereRe-evaluate the long-term demand base; for consumer-dependent names, this is often a slow-moving but fatal headwind — assess whether the thesis still holds at a structurally lower growth path

The red line on macro trends (demographic clock / consumption / generational) is deliberately explicit: a value-investing thesis that picks a consumer name without weighing population decline and consumption-trend headwinds is incomplete. For non-consumer names (e.g. pure B2B industrial), this red line may be loose; for consumer/retail/education/property names, weight it heavily.

Duan Yongping: "There are only three reasons to sell: 1. you got the buy wrong; 2. the fundamentals changed; 3. you found something better."

A4: Valuation Anchors
MetricAt buyOptimistic targetNeutral targetPessimistic
Price
PE (TTM)
Market cap
Intrinsic value estimate
Margin of safety
A5: Save the Thesis

Use write_file to write reports/{company}-thesis.md, including: build date, buy price and position, core thesis (5 sentences), assumptions list, red lines, valuation anchors, tracking table (empty initially).


Mode B: Tracking Check

B1: Read the Existing Thesis

Use read_file to load core thesis, assumptions, red lines, last check record.

B2: Gather Latest Data

Use web_search / get_stock_news / get_financial_statements: ① latest earnings (if new quarter/year); ② recent material events (management, regulation, competition); ③ current price and valuation; ④ insider transactions (major shareholder changes).

Show full SKILL.md (376 more words)Show less
B3: Check Each Assumption
#Core AssumptionLast statusLatest evidenceCurrent statusChange
1Revenue growth >15%🟢 HoldingQ4 revenue growth 12%🟡 Weakening⚠️

Status definitions:

  • 🟢 Holding — latest data supports
  • 🟡 Weakening — still acceptable, but trend is unfavorable
  • 🔴 Impaired — data clearly does not support
  • ⚫ Broken — assumption has been overturned
B4: Red-Line Check

Check each red line; any triggered → flag prominently in the report + clear action recommendation.

B5: Valuation Update

Use financial_rigor (command=verify_valuation) to recompute PE/PB/ROE; compare against buy-time and last check:

MetricAt buyLast checkCurrentChange
Price
PE (TTM)
Intrinsic value estimate
Margin of safety
B6: Output the Tracking Report

Structure: ① Thesis health score (out of 10); ② Assumption check table; ③ Red-line check table; ④ Key changes this period (≤500 words); ⑤ Valuation update; ⑥ Conclusion and action; ⑦ Focus for next check.

Health formula: 10 - (⚫broken × 3) - (🔴impaired × 2) - (🟡weakening × 1) - (red-lines triggered × 5), min 1, max 10.

ScoreMeaningAction
9-10All assumptions hold, thesis stronger than at buyConsider adding
7-8Core assumptions hold, some weakeningContinue holding
5-61-2 assumptions impaired, core logic intactHold but raise alertness
3-4Multiple assumptions impaired, foundation shakenConsider trimming
1-2Red line triggered or core assumption brokenStrongly consider exit

The conclusion must clearly answer: ① Is the thesis still intact? (intact / weakening / impaired / broken); ② What to do? (add / hold / trim / exit); ③ Next check timing (next earnings / a specific event).

B7: Update the Thesis File

Use write_file to append this check to the tracking table in reports/{company}-thesis.md:

Check dateHealthKey changeAction
2026-04-097/10Revenue growth slowed to 12%, but margins improvedHold

Key Principles

  • Write sell conditions before buying — decisions made calmly beat decisions made in panic.
  • Assumptions must be verifiable — "a great company" is not a thesis; "ROE>25% and stable" is.
  • Act when a red line triggers — "let's wait and see" is how big losses happen.
  • Thesis breaking ≠ stock falling — a 30% price drop doesn't force a sell; a broken thesis does.
  • Be honest about mistakes — if the thesis was wrong, admit it; don't defend it to save face.
  • Weigh macro headwinds for consumer names — demographic decline and consumption downgrade are slow but can be fatal for consumer/property/education theses; bake them into red lines, not just quarterly checks.

© HKUDS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in agent/src/skills/thesis-tracker of HKUDS/Vibe-Trading.

Open the folder on GitHubat commit 14cabaf

Compare with similar skills

Investment Thesis Tracker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Investment Thesis Tracker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Investment Thesis Tracker this skillHKUDS/Vibe-Trading35k—~2.2kAutomated safety check: PassMIT
AI-Trader Market IntelHKUDS/AI-Trader23k—~1.1kAutomated safety check: PassNone
Stock Deep Analysis Workflowwbh604/UZI-Skill7.1k—~9.1kAutomated safety check: NotesMIT
Zhengxi Fund Manager Views Librarylyra81604/zhengxi-views1.7k—~1.6kAutomated safety check: PassMIT
Supply Chain Bottleneck Hunterxbtlin/ai-berkshire17k—~2.6kAutomated safety check: PassMIT
Deep Company Article Seriesxbtlin/ai-berkshire17k—~2kAutomated safety check: PassMIT

Similar skills

  • AI-Trader Market Intel

    HKUDS/AI-Trader

    Reads AI-Trader's read-only market snapshots, grouped financial news and events board through its market-intel endpoints, for context before trading or posting.

    23k GitHub stars~1.1k tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed
  • Runs a staged deep analysis of a single stock on China A-share, Hong Kong and US markets, ending in an HTML report with valuation models and investor-panel scores.

    7.1k GitHub stars~9.1k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check: notes
  • Zhengxi Fund Manager Views Library

    lyra81604/zhengxi-views

    Answers questions with sourced quotes from one Chinese fund manager's public writings, applies his stated investment method and compares his words with real fund holdings.

    1.7k GitHub stars~1.6k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Scans a long-running industry trend for supply chain chokepoints, aiming to find second- and third-layer suppliers that the market has not yet priced in.

    17k GitHub stars~2.6k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Deep Company Article Series

    xbtlin/ai-berkshire

    Plans and writes a three-to-eight-part long-form article series that breaks down one company, built on fact-checked financials, valuation and management analysis.

    17k GitHub stars~2k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Longbridge Earnings

    helsome/folio

    Earnings analysis — pre- and post-earnings. An agent skill from helsome/folio.

    269 GitHub starsUsed in 1 repo~2.5k tokens
    Business, Finance & HRAuto-check passed

More from HKUDS/Vibe-Trading

All 89 skills in this repo
  • Eastmoney Market Data

    HKUDS/Vibe-Trading

    Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.

    35k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • OKX Market Data

    HKUDS/Vibe-Trading

    Retrieves public OKX cryptocurrency market data such as spot prices, candlesticks, funding rates and open interest through the OKX V5 REST API, with no authentication.

    35k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • SEC EDGAR Filings Fetcher

    HKUDS/Vibe-Trading

    Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.

    35k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • A-Share ST Risk Screener

    HKUDS/Vibe-Trading

    Predicts whether a mainland China A-share company risks an ST or *ST warning after its next annual report, using financial thresholds and Sina penalty records.

    35k GitHub stars~4.9k tokensUpdated today
    Auto-check passed
  • Breaks a structural trend such as AI infrastructure into its physical supply chain and ranks lesser-known listed companies sitting on each bottleneck.

    35k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Plans and drafts an eight-part, roughly 120k-word investigative series on one company, built around a strict fact-check pass rather than fast drafting.

    35k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

Questions about Investment Thesis Tracker

What does Investment Thesis Tracker do?

Keeps a written investment thesis for each stock you hold and re-checks it every quarter against new earnings, scoring its health and recommending hold, add, trim or exit. The skill addresses a common gap: without written sell conditions, investors hold too long, panic-sell on dips, or forget why they bought in the first place. Following Buffett and Li Lu, it writes the sell conditions before the first quarterly check.

When should I use Investment Thesis Tracker?

Investment Thesis Tracker fits situations like: writing an investment thesis right after buying a stock; re-checking a holding's thesis each earnings season; deciding whether to hold, add, trim or exit a position; working out why a stock was bought in the first place.

How do I install Investment Thesis Tracker in Claude Code?

Run `npx skills add HKUDS/Vibe-Trading --skill thesis-tracker -a claude-code`. Or copy the skill folder (agent/src/skills/thesis-tracker in HKUDS/Vibe-Trading) into .claude/skills/thesis-tracker in your project. Claude Code loads it when a task matches its description.

How do I install Investment Thesis Tracker in Codex?

Run `npx skills add HKUDS/Vibe-Trading --skill thesis-tracker -a codex`. Or copy the skill folder (agent/src/skills/thesis-tracker in HKUDS/Vibe-Trading) into .agents/skills/thesis-tracker in your project. Codex loads it when a task matches its description.

Can I use Investment Thesis Tracker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/Vibe-Trading --skill thesis-tracker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/thesis-tracker, .gemini/skills/thesis-tracker, .github/skills/thesis-tracker and .opencode/skills/thesis-tracker in your project.

What does Investment Thesis Tracker need to run?

SKILL.md names no scripts, command-line tools or credentials: Investment Thesis Tracker is instructions for the agent only. Our summary lists: Web search access for current price and financial data; A valuation and market-cap verification tool.

Does Investment Thesis Tracker access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Investment Thesis Tracker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Investment Thesis Tracker use?

Investment Thesis Tracker is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Investment Thesis Tracker use?

About 2.2k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Investment Thesis Tracker?

Skills that share tags, products or a category with Investment Thesis Tracker: AI-Trader Market Intel (HKUDS/AI-Trader, 23k stars), Stock Deep Analysis Workflow (wbh604/UZI-Skill, 7.1k stars), Zhengxi Fund Manager Views Library (lyra81604/zhengxi-views, 1.7k stars) and Supply Chain Bottleneck Hunter (xbtlin/ai-berkshire, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Investment Thesis Tracker?

HKUDS (a GitHub organization) maintains it in HKUDS/Vibe-Trading, which has 34,949 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 8, 2026.

Source: HKUDS/Vibe-Trading on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.