portfolio-brief
Skill1 starsChanged 22 days agoMITView on GitHub
On-demand, read-only portfolio brief for a brokerage account exposed through the portfolio MCP server — P&L, concentration, FX exposure, upcoming earnings for holdings, and news behind notable moves. Use when the user asks for a portfolio brief (daily or weekly), "how is my portfolio", or what is moving in their holdings. Never scheduled; runs only when asked. Never places, suggests placing, or prepares an order.
In this repository3 other files it gives its agents.
- web/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- web/CLAUDE.mdCLAUDE.md
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Read-only, always: Never place, modify or cancel an order, and never call a tool that could.
- Very specific: line 15
Every number comes from
get_brief_data: Do not compute weights, percentages, totals or dates yourself. - Distinctive: line 18
Nothing leaves the chat: Do not write the brief, amounts or holdings into any file in the repository.
- Distinctive: line 21
No silent gaps: If a tool fails or returns nothing (earnings lookup, news), say so in the brief.
- Very specific: line 26
Call avanza-portfolio → get_brief_data (earnings_within_days: 30 for daily, 45 for weekly).
- Distinctive: line 39
Write the brief in the format below.
- Distinctive: line 75
Keep it tight. A daily brief should read in under a minute.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Portfolio brief
Argument: daily (default) or weekly.
Hard rules
- Read-only, always. Never place, modify or cancel an order, and never call a tool that could. Only an explicit, unambiguous instruction from the user could change this, and the skill does not assume one.
- Every number comes from
get_brief_data. Do not compute weights, percentages, totals or dates yourself. Quote the tool's fields. If a number is not there, say it is not available rather than deriving it. - Nothing leaves the chat. Do not write the brief, amounts or holdings into any file in the repository. Save to a location outside the repo only if the user names one.
- No silent gaps. If a tool fails or returns nothing (earnings lookup, news), say so in the brief. Do not omit the section.
Steps
- Call
avanza-portfolio→get_brief_data(earnings_within_days: 30 for daily, 45 for weekly). - For weekly, also call
get_transactionswithfrom_date= 7 days ago. List trades and sumcommissionper trade. Quote each one. State the total as "commissions paid this week" only if every trade has a commission value. News, targeted, not a firehose. Fetch news only for holdings in
flags(big day move, deep loss) or inearnings.upcoming, plus the top 3 holdings by weight:- stocks:
yahoo-finance→get_yahoo_finance_news - market context:
efn-news→get_latest_newsorget_market_commentary(one call; skim for anything touching holdings or currency and rates)
For each flagged move, find the actual catalyst. If you cannot find one, write "no identifiable catalyst found". Do not invent a reason.
- stocks:
- Write the brief in the format below.
Format
PORTFOLIO BRIEF — <daily|weekly> — <as_of>
Value <portfolio> <currency> · invested <invested> · cash <cash> (<cash_pct>%)
Unrealized <unrealized_pnl> <currency> (<unrealized_pnl_pct>%)
1d <insights_total> · 1w <change> (<pct>%) · 1m … · ytd …
MOVERS & FLAGS
- <name> <day_change_pct>% today — <catalyst, or "no identifiable catalyst">
- <name> <pnl_pct>% unrealized — <one line: thesis intact / broken / unknown>
- stale prices: <list, or none>
CONCENTRATION
Top holding <name> <top1>% of invested · top 3 <top3>%
By type: … · By currency: …
EARNINGS AHEAD (<within_days>d)
- <ticker> <date> (in <n> days), or "none"; list lookup failures explicitly
NEWS THAT MATTERS
- 2–5 bullets, each tied to a specific holding or to currency and rates. Source-linked.
WEEK IN TRADES (weekly only)
- <date> <BUY/SELL> <instrument>, commission <x> <currency>
WORTH A LOOK (optional, max 2)
- Observations only, e.g. "<name> is 3% of invested and down 15%: earnings in 12
days decides whether the thesis holds." No buy or sell instructions. If the user
asks about acting on one, apply the repository's trading rules first (take-profit
and stop-loss before entry, leverage cap, earnings check).Keep it tight. A daily brief should read in under a minute.
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.

