CtrlK
BlogDocsLog inGet started
Tessl Logo

portfolio-manager

Comprehensive portfolio analysis using Alpaca MCP Server integration to fetch holdings and positions, then analyze asset allocation, risk metrics, individual stock positions, diversification, and generate rebalancing recommendations. Use when user requests portfolio review, position analysis, risk assessment, performance evaluation, or rebalancing suggestions for their brokerage account.

62

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/portfolio-manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered operational skill: concrete tool names, endpoints, thresholds, validation steps, and a genuinely well-wired one-level-deep reference bundle. Its main weakness is token efficiency — duplicated trigger lists, re-explanations of standard finance concepts, and long illustrative templates inflate the body well beyond what the workflow requires.

Suggestions

Merge 'Example Queries' into 'When to Use' (they are near-duplicates) and cut both down to a short list of representative phrasings.

Move the 'Advanced Features' sections (tax-loss harvesting, dividend income, correlation matrix, scenario analysis) and the full report template into a reference file, keeping only a one-line pointer plus the report filename/structure skeleton in SKILL.md.

Trim Steps 2–3 to the non-obvious specifics (which MCP tools, which thresholds, which fallback endpoints) and drop the enumeration of standard metrics (P/E, moving averages, RSI) that Claude already knows.

DimensionReasoningScore

Conciseness

The ~780-line body has several padded or duplicative sections: 'Example Queries' repeats the 'When to Use' trigger list almost verbatim, 'Advanced Features' explains concepts Claude already knows (tax-loss harvesting with wash-sale rules, yield on cost, correlation matrices, scenario analysis), and Steps 2–3 re-enumerate standard finance metrics (P/E, moving averages, RSI, beta) at length. This matches the anchor 'noticeably verbose; several unnecessary explanations or padded sections' — the core workflow itself is efficient, but the padding is substantial.

2 / 5

Actionability

Guidance is largely concrete and executable: named MCP tools (mcp__alpaca__get_positions), exact REST endpoints with auth headers, a copy-paste-ready connection check command (`uv run python skills/portfolio-manager/scripts/check_alpaca_connection.py`), and quantified thresholds (flag positions >10-15%, sectors >30-40%, 15-30 optimal stocks). The gap that keeps it from 5: the REST fallback lists endpoints and headers but never shows an actual curl/python invocation, and 'Use WebSearch or available market data APIs' for enrichment is underspecified.

4 / 5

Workflow Clarity

A clear 7-step sequence with numbered sub-steps, an explicit 'Data Validation' block in Step 1 (ticker validity, market values reconciling to equity), and a dedicated Error Handling section covering disconnected MCP, incomplete data, and stale data — most checkpoints are present. It misses anchor 5's explicit feedback loops (e.g., what to do and re-check when reconciliation fails is only implied by 'highlight margin/leverage'), though as a read-only analysis skill it avoids the destructive/batch cap.

4 / 5

Progressive Disclosure

Bundle structure is verified real: all 8 referenced files exist in references/, the script exists at scripts/check_alpaca_connection.py, and each reference is signaled twice — inline at point of use ('Read references/asset-allocation.md for allocation frameworks') and in a Resources section with When/Contains annotations — all one level deep. It falls short of 5 because substantial content that could live in references (long illustrative report templates, the Advanced Features material, the Analysis Frameworks templates) is inlined, making the overview file itself heavy.

4 / 5

Total

14

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, explicit what-and-when structure, concrete capability list, and natural trigger phrases anchored to the brokerage-account context. The only gaps are a few missing synonym triggers and slight overlap risk with individual-stock analysis skills.

DimensionReasoningScore

Specificity

The description enumerates concrete actions — 'fetch holdings and positions', 'analyze asset allocation, risk metrics, individual stock positions, diversification', and 'generate rebalancing recommendations' — giving comprehensive coverage of the skill's capabilities, with only the mild buzzword 'Comprehensive' as padding.

5 / 5

Completeness

It explicitly answers both questions: the first sentence states what the skill does (fetch via 'Alpaca MCP Server integration', then the listed analyses), and 'Use when user requests portfolio review, position analysis, ... for their brokerage account' gives concrete when-guidance, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'portfolio review', 'position analysis', 'risk assessment', 'performance evaluation', and 'rebalancing suggestions' are all things a user would actually say, but common variations such as 'holdings', 'my stocks', or 'brokerage' as a standalone trigger word are only partially covered ('brokerage account' appears once as a qualifier).

4 / 5

Distinctiveness Conflict Risk

The Alpaca/brokerage-account framing carves out a clear niche that mostly distinguishes it from single-stock analysis skills, but broad triggers like 'What stocks should I buy or sell?'-adjacent phrases ('rebalancing suggestions', 'risk assessment') create minor overlap with general stock-screening or stock-analysis skills.

4 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (784 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
tradermonty/claude-trading-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.