clarion-watchlist-update

Refreshes prices on the latest stock watchlist and flags large movers, trigger hits, and stale screens.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/SillyHippy/zo-skills --skill clarion-watchlist-update-sillyhippy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarion-watchlist-update
Source: https://github.com/SillyHippy/zo-skills/tree/main/skills/clarion-watchlist-update
Command: npx skills add https://github.com/SillyHippy/zo-skills --skill clarion-watchlist-update-sillyhippy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yfinance, and includes scripts (resource) and references (resource) components.

What problem does it solve? A value-investing watchlist goes stale quickly: prices drift, entry zones get hit or missed, and nobody notices without manually re-checking every ticker. This Skill automates that daily check by re-pricing the latest screen and surfacing only what deserves attention. ## Core Features & Use Cases - Price Refresh & Move Detection: Reads the latest watchlist from ~/clarion/watchlists/, fetches current prices via yfinance, and computes the % move since the screen for every ticker. - Big-Mover Flagging: Highlights tickers that moved more than a configurable threshold (default 10%) in either direction, with guidance on whether the entry case weakened or a fresh look is warranted. - Watchlist Thesis Tracking: Pulls every thesis with status:watchlist from ~/clarion/theses/ and shows current price versus cost basis. - Staleness Detection: Flags screens older than 14 days (configurable) and suggests running clarion-value-screener for a refresh. - Use Case: Each morning before market open, ask for a watchlist update to see which screened names dropped more than 10% — those are candidates for a full single-stock evaluation. ## Quick Start Ask the assistant to run a watchlist update and show what has moved since the latest screen.

Frequently Asked Questions about clarion-watchlist-update

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

FAQPage Schema
How do I check which stocks on my watchlist have moved?

Run the update script with no arguments to re-price every ticker on the latest watchlist via yfinance and compute the percent move since the screen. Tickers moving more than 10% in either direction are flagged as big movers in the report.

How do I track watchlist theses against their cost basis?

The script reads every thesis with status:watchlist from ~/clarion/theses/ and displays current price versus the recorded cost basis. For exact entry-zone checks, open the thesis file directly since prose-heavy position management sections are not parsed.

Can I change the mover threshold or staleness limit?

Yes, use --threshold-pct to set the big-mover cutoff (default 10 percent) and --max-stale-days to set when a screen is flagged stale (default 14 days). The --top-only flag limits output to the top sector-capped names.

Does the watchlist update modify my watchlist file?

No, the skill is strictly read-only and never modifies the watchlist file. To generate a fresh screen with updated rankings, run the clarion-value-screener skill instead.

Why does the watchlist update report no watchlists found?

The error WATCHLIST_UPDATE_ERROR: no watchlists means ~/clarion/watchlists/ is empty, so there is no screen to re-price. Run clarion-value-screener first to generate a watchlist, then rerun the update.

What happens when yfinance fails to fetch a price?

A failed fetch produces a non-fatal warning for that ticker, which is then shown without a current price or move percentage. The rest of the watchlist report still renders normally.