ib-portfolio

Get portfolio positions from Interactive Brokers. Use when user asks about their portfolio, positions, holdings, or what stocks they own. Requires TWS or IB Gateway running locally.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%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 tight, actionable skill body that gives a copy-paste command backed by a real script, clear arg/output specs, and a well-specified connection fallback workflow. Structure is clean and appropriately scoped for a simple single-purpose skill.

Dimension	Reasoning	Score
Conciseness	The body is efficient and assumes competence: a port table, the runnable command, args, and output schema with little padding, though the thin Dependencies section and the uv fallback caveat are minor instances that could be trimmed.	4 / 5
Actionability	"uv run python scripts/portfolio.py [--port PORT]" is copy-paste ready, the referenced script portfolio.py exists and matches the documented args, and the output JSON shape is fully specified.	5 / 5
Workflow Clarity	This is a simple single-action skill with an unambiguous command, and it additionally specifies an explicit port-fallback feedback loop with memory persistence and a user-facing error recovery path when both ports fail.	5 / 5
Progressive Disclosure	At under 50 lines with no need for external references, the body is well organized into clear sections (IB Connection, Instructions, Arguments, Output, Dependencies, Timezone) and the one referenced path, scripts/portfolio.py, is a real one-level-deep file.	5 / 5
	Total	19 / 20 Passed

Description

82%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, well-targeted description that cleanly answers what the skill does and when to use it with natural trigger terms. The only mild gap is that it names a single concrete action rather than a broader set of capabilities.

Dimension	Reasoning	Score
Specificity	"Get portfolio positions from Interactive Brokers" names the domain and one concrete action (fetching positions), matching the score-3 anchor of domain plus 1-2 concrete actions without comprehensive coverage.	3 / 5
Completeness	It explicitly states both what it does ("Get portfolio positions from Interactive Brokers") and when to use it ("Use when user asks about their portfolio, positions, holdings, or what stocks they own") with concrete trigger phrases.	5 / 5
Trigger Term Quality	"portfolio, positions, holdings, or what stocks they own" gives good natural keyword coverage with several synonyms a user would actually say, though a few related terms (e.g. account, balance, brokerage) are absent.	4 / 5
Distinctiveness Conflict Risk	The Interactive Brokers niche and position-specific trigger terms make it clearly distinguishable from other skills with minimal conflict risk.	5 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: staskh/trading_skills
Path: .claude/skills/ib-portfolio/SKILL.md
Commit: 9a1bf57

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.