Tessl • The management layer for AI agent skills

SkillPublic

risk-assessment

Assess risk metrics for a stock or position including volatility, beta, VaR, and drawdown analysis. Use when user asks about risk, volatility, beta, VaR, value at risk, drawdown, or position sizing.

Quality

89%

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, well-organized single-command skill: the invocation, arguments, and output schema are all concrete and consistent with the bundled script. The only improvement worth making is a worked example invocation and slightly fuller post-run guidance.

Suggestions

Add one concrete example invocation, e.g. `uv run python scripts/risk.py AAPL --period 6mo --position-size 10000`, so the common case is copy-paste ready.

The Dependencies section lists numpy/yfinance but the script imports the `trading-skills` package (declared in frontmatter); aligning these would prevent an import failure when a user installs only the listed dependencies.

Dimension	Reasoning	Score
Conciseness	The ~45-line body is lean: a one-line summary, a single runnable command with a practical uv fallback note, terse argument and output tables, and no explanation of concepts Claude already knows. Every token earns its place.	5 / 5
Actionability	"uv run python scripts/risk.py SYMBOL [--period PERIOD] [--position-size SIZE]" is a concrete executable command with fully documented arguments and output fields (verified against the real scripts/risk.py), but there is no worked example invocation (e.g. a real symbol with a chosen period) to cover the common case.	4 / 5
Workflow Clarity	This is a simple single-action skill: run one read-only command, then "Explain what the risk metrics mean and suggest position sizing if relevant". The single action is unambiguous, no destructive or batch operations are involved, so no validation checkpoints are required.	5 / 5
Progressive Disclosure	Under 50 lines with no external reference material needed; sections (Instructions, Arguments, Output, Dependencies, Timezone) are well-organized and the referenced scripts/risk.py exists in the bundle, matching its documented interface.	5 / 5
	Total	19 / 20 Passed

Description

83%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 that explicitly states both capabilities and trigger conditions with concrete metric names and a natural synonym expansion of VaR. The main gaps are a few missing natural trigger phrases and single-verb action framing.

Suggestions

Add natural trigger phrases users would say, e.g. "sharpe ratio", "risk analysis", or "how risky is this stock", to broaden keyword coverage.

Mention the position-specific output (dollar VaR for a position size) in the capability clause so the 'what' matches everything the skill computes.

Dimension	Reasoning	Score
Specificity	"Assess risk metrics for a stock or position including volatility, beta, VaR, and drawdown analysis" names the domain and several concrete capabilities, but uses a single action verb and omits outputs the skill actually produces (Sharpe ratio, position risk), leaving minor coverage gaps.	4 / 5
Completeness	Both what ("Assess risk metrics... including volatility, beta, VaR, and drawdown analysis") and when ("Use when user asks about risk, volatility, beta, VaR, value at risk, drawdown, or position sizing") are explicitly and concretely stated.	5 / 5
Trigger Term Quality	"Use when user asks about risk, volatility, beta, VaR, value at risk, drawdown, or position sizing" covers good natural terms including the spelled-out synonym "value at risk", but omits a few natural phrases users would say such as "sharpe ratio", "risk analysis", or "how risky is this stock".	4 / 5
Distinctiveness Conflict Risk	Financial risk metrics (VaR, beta, drawdown) form a distinct niche, but broad trigger terms like "risk" and "position sizing" could overlap with closely related trading or portfolio-analysis skills.	4 / 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/risk-assessment/SKILL.md
Revision: b71a74f

Reviewed: 26 days ago

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.

risk-assessment

Table of Contents

Is this your skill?