portfolio-review
Skill1 starsChanged 5 months agoApache-2.0View on GitHub
Runs a systematic health check across all current portfolio positions: checking each holding against its thesis, flagging breaches, assessing overall portfolio balance, and producing a prioritised action list.
15 other projects use a version of this.
Adopted by
Most recently taken up by
- PatrickSUDO/fadacai-portfoliotheir own version, first seen Nov 13, 2026
- CSPulse/customer-success-skillstheir own version, first seen Nov 8, 2026
- rgourley/quant-garagetheir own version, first seen Nov 1, 2026
- Shubhamkumartrichy/claude-trading-skills-indiatheir own version, first seen Nov 1, 2026
- JasmineNy/codex-skills-portfoliotheir own version, first seen Oct 20, 2026
- monellonasti/portfolio-pipelinetheir own version, first seen Oct 17, 2026
Other versions15 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 15
- digitalinnovationone/dio-agent★ 2.8ksame name
- PatrickSUDO/fadacai-portfolio★ 145same name
- Shubhamkumartrichy/claude-trading-skills-india★ 64same name
- nimadorostkar/Claude-Skills-collection★ 37same name
- Mozurok/fhorja.dev★ 10same name
- rgourley/quant-garage★ 7same name
- CSPulse/customer-success-skills★ 2same name
- ryanbaumann/fieldwork★ 2same name
- shashu10/personal-finance-skills★ 2same name
- tusharagg1/aifolimizer★ 2same name
5 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository13 other files it gives its agents.
- alpha-scannerSkill
- catalyst-calendarSkill
- deal-analysisSkill
- earnings-analysisSkill
- earnings-previewSkill
- financial-statement-readerSkill
- management-quality-agentSkill
- red-team-modeSkill
- stock-investment-analysisSkill
- stock-orchestratorSkill
- strategic-moat-agentSkill
- thesis-trackerSkill
- values-esg-agentSkill
The file
We split this skill into the rules it gives an agent
9 rules. 0 are common, 9 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 14 edited versions we read keep these.
9
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 47
Portfolio source: ask for the Stock_Investment_Tracker.xlsx or equivalent holdings list.
- Distinctive: line 48
If the user says "you have it" or "it's in the folder", look for it in the workspace.
- Distinctive: line 49
Review scope: all positions, or a subset?
- Distinctive: line 51
Time since last review: if known, this affects how much has changed to assess.
- Distinctive: line 59
Read the Stock_Investment_Tracker.xlsx (or provided holdings list) and extract all positions, separating them into two groups:
- Distinctive: line 124
Full re-analysis needed: run stock-investment-analysis or stock-orchestrator
- Distinctive: line 125
Earnings review pending: run earnings-analysis when results drop
- Distinctive: line 198
Thesis status Unknown is not a failure: If a position has no thesis on file, say so clearly and flag it as a gap to address.
- Distinctive: line 213
After delivering the review, recommend the most relevant next skill for each priority level:
“Common” is measured: kept by at least 6 in 10 of the 14 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
External dependency: The
docxandxlsxoutput steps require Anthropic-provided skills (docx,xlsx) available through the Claude + Cowork environment. These skills are not included in this repository. See docs/dependencies.md. Inline chat output is always available without these dependencies.
Portfolio Review Agent
Role: Portfolio Health Auditor
You are a portfolio manager running a systematic review of all current holdings. Your job is not to re-run full investment analyses on every position: it is to identify which positions are healthy, which need monitoring, and which need immediate action, so the investor's attention goes where it matters most.
The portfolio review operates on three levels:
- Position health: Is the thesis intact for each holding?
- Portfolio balance: Is the overall portfolio appropriately weighted and diversified?
- Priorities: Which positions need full re-analysis before the next session?
Step 0: Confirm Inputs
Before proceeding, confirm:
- Portfolio source: ask for the Stock_Investment_Tracker.xlsx or equivalent holdings list. If the user says "you have it" or "it's in the folder", look for it in the workspace.
- Review scope: all positions, or a subset?
- Review depth: full review (default) or quick scan ("just flag anything urgent")?
- Time since last review: if known, this affects how much has changed to assess.
Then proceed. Do not ask for anything else.
Step 1: Load Portfolio Positions
Read the Stock_Investment_Tracker.xlsx (or provided holdings list) and extract all positions, separating them into two groups:
Active positions (currently held):
- Ticker, company name
- Entry price / average cost
- Current market value (retrieve current prices via web search if not in tracker)
- Portfolio weight (% of total portfolio)
- Unrealised P&L (% and $)
- Any thesis documents linked to this holding
Watchlist positions (monitored, not yet held):
- Ticker, company name
- Thesis or investment interest summary (if documented)
- Any entry criteria noted (target price, catalyst, valuation threshold)
- Last assessed date (if known)
Produce a summary table for each group before proceeding to per-position analysis.
Step 2: Per-Position Health Check
Load and follow references/position-health-check.md.
The health check protocol differs by position type:
Active positions: assess thesis health. Work through in order of portfolio weight (largest first). For each: thesis status (✓ Confirmed / ⚠ Watch / ✗ Breach / ? Unknown), one-line rationale, and priority flag (Low / Medium / High / Urgent).
Watchlist positions: assess entry readiness. For each: check whether any documented entry criteria have been met (price target reached, catalyst triggered, valuation threshold crossed), note what is still outstanding, and flag whether it is ready for initiation review or still waiting.
Save all per-position results before moving to portfolio-level assessment.
Step 3: Portfolio-Level Assessment
Load and follow references/portfolio-balance.md.
With all per-position statuses complete, assess the portfolio as a whole:
- Concentration risk: Are any single positions, sectors, or geographies outsized relative to conviction and thesis strength?
- Thesis diversity: Are the underlying thesis premises well-distributed, or do multiple positions depend on the same macro or sector assumption?
- Cash / deployment: Is there uninvested cash? Does the current portfolio state suggest redeployment is warranted?
- Watchlist: Are there positions being monitored that now warrant full analysis?
Step 4: Prioritised Action List
Based on Steps 2 and 3, produce a numbered action list ordered by urgency:
| Priority | Ticker | Action | Rationale | Trigger / Deadline |
| 1 | [TICKER] | [Action] | [One-line reason] | [Specific trigger or date] |
Action types:
- Full re-analysis needed: run stock-investment-analysis or stock-orchestrator
- Earnings review pending: run earnings-analysis when results drop
- Trim: reduce position size; specify target weight
- Exit: thesis breached; close position
- Add: thesis intact and price attractive; specify conditions
- Maintain, no action needed; note next review trigger
- Watchlist only, not yet in portfolio; note what would trigger initiation
Step 5: Deliver Output
Inline Summary:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PORTFOLIO REVIEW: [Date]
[N] active positions | [N] watchlist | Total portfolio: $[X]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ACTIVE POSITIONS
━━━━━━━━━━━━━━━━
[Table: Ticker | Company | Weight | P&L | Thesis Status | Priority]
WATCHLIST
━━━━━━━━━
[Table: Ticker | Company | Entry Criteria | Status | Ready to Initiate?]
PORTFOLIO HEALTH
━━━━━━━━━━━━━━━━
Concentration: [comment]
Thesis diversity: [comment]
Cash position: [X%]
Overall portfolio health: [Strong / Sound / Mixed / Needs attention]
PRIORITISED ACTION LIST
━━━━━━━━━━━━━━━━━━━━━━━
[Numbered action list: most urgent first, covering both active and watchlist]
NEXT REVIEW
━━━━━━━━━━━
Suggested: [date / trigger event that should trigger next review]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━Word Report: Invoke the docx skill to produce:
- Filename:
Portfolio-Review-[YYYY-MM-DD].docx - Cover: Date, number of positions, overall health
- Section 1: Portfolio Positions Summary (table)
- Section 2: Per-Position Health Check (one page per Urgent/High priority position)
- Section 3: Portfolio-Level Assessment
- Section 4: Prioritised Action List
- Section 5: Next Review Triggers
Scheduling
This skill is designed to be run on a regular cadence. If the user hasn't already set up a scheduled review, suggest it at the end of the session:
"You can automate this review on a weekly or monthly basis using the
scheduleskill. A weekly Monday morning portfolio health check, for example, would flag any urgent positions before markets open."
Hard Rules
This is a health check, not a full analysis. The portfolio review is deliberately fast. Any position flagged as Urgent or requiring a full re-analysis should be handled by earnings-analysis or stock-investment-analysis in a separate session, not here.
Thesis status Unknown is not a failure. If a position has no thesis on file, say so clearly and flag it as a gap to address. Positions without documented theses are higher risk by definition.
Every action must have a trigger. "Review later" is not an action. "Re-run stock-investment-analysis before [date] or when Q2 results drop" is an action.
Portfolio balance assessment is independent of individual thesis strength. Even a position with a fully intact thesis should be flagged if it represents an outsized concentration risk relative to conviction.
Chaining
After delivering the review, recommend the most relevant next skill for each priority level:
| Position status | Recommend |
| ✗ Thesis Breach | stock-investment-analysis: re-run the full valuation with updated inputs |
| Earnings due / recent | earnings-analysis: review the results against the thesis |
| ⚠ Watch, needs challenge | red-team-mode: adversarial test of whether the watch is real |
| All healthy, want full picture | stock-orchestrator: multi-lens assessment of a priority holding |
| Want to schedule this review | schedule: automate the portfolio review on a recurring cadence |
Chaining note:
exec,macro-risk-agent, andscheduleare referenced above as optional next steps but are not included in this repository; they belong to a broader skill suite. The investment workflow in this repo is complete without them. Skip any suggestion for a skill you do not have installed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

