CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-trading-predictor

Agent skill for trading-predictor - invoke with $agent-trading-predictor

55

3.27x
Quality

32%

Does it follow best practices?

Impact

95%

3.27x

Average score across 3 eval scenarios

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-trading-predictor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

36%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.

The body is a marketing-style capability catalog rather than an operational skill: verbose buzzword bullets, semi-concrete MCP examples mixed with undefined pseudocode, and workflows without any validation or feedback loops. It also opens with a stray duplicated YAML frontmatter block ('---\nname: trading-predictor...---'), a structural defect, and its central premise (executing trades before market data physically arrives, beating light-speed transmission) is physically impossible over-claiming that no validation step could support.

Suggestions

Cut the buzzword bullet catalogs (Advanced Trading Strategies, Performance Metrics, Integration Patterns) and the marketing opener/closer; keep only the concrete MCP tool usage and one complete workflow, trimming the file by well over half.

Replace the sandbox Python example's undefined functions (connect_market_feeds, calculate_temporal_lead, optimize_execution) with real, executable code, and remove the duplicated embedded frontmatter block at the top of the body.

Add explicit validation checkpoints and error-recovery loops to the trading workflows (e.g. pre-trade risk/VaR limit check, abort condition on anomaly detection, post-execution reconciliation), and move API details and strategy material into reference files in references/.

DimensionReasoningScore

Conciseness

The body opens with marketing prose ('a cutting-edge financial AI that exploits temporal computational advantages... exceeds light-speed data transmission times') and pads ~240 lines with buzzword bullet lists ('Latency Arbitrage', 'Information Asymmetry', 'the pinnacle of algorithmic trading technology') that add almost no actionable information. It does not re-explain concepts Claude already knows, so it sits between the severely-verbose (1) and mostly-efficient (3) anchors, noticeably below the midpoint.

2 / 5

Actionability

The MCP tool examples are semi-concrete (e.g. `mcp__sublinear-time-solver__calculateLightTravel({ distanceKm: 10900, matrixSize: 5000 })` with named result fields), but the Python sandbox example calls undefined functions (`connect_market_feeds()`, `calculate_temporal_lead()`, `optimize_execution()`) and much of the body is capability naming rather than instruction. This matches the anchor 'some concrete guidance but incomplete; pseudocode instead of executable code; missing key details', and is not level 4 because key execution details are fabricated/undefined, nor level 2 because the MCP call signatures are genuinely usable.

3 / 5

Workflow Clarity

The 'Example Trading Workflows' sections give a rough sequence ('1. Pre-Market Analysis... 5. End-of-Day Reconciliation') but each step is vague ('Execute trades using temporal advantage algorithms') with zero validation checkpoints for a risky, batch-oriented trading domain — no position checks, no error-recovery loops, no fail-safe triggers. This fits 'rough sequence present but many gaps; steps poorly defined; validation absent' and is below level 3 because even the listed steps describe rather than instruct.

2 / 5

Progressive Disclosure

The document has a clear section hierarchy (Core Capabilities, Usage Scenarios, Risk Management Framework, Integration Patterns), but it is a monolithic ~250-line inline file with no bundle files and no references to separate files — API usage details, strategy catalogs, and metrics lists are all inlined where a well-structured skill would split them. This matches 'some structure but could be better organized; content that should be separate is inline'; it is above level 2 only because section headers do provide real navigation.

3 / 5

Total

10

/

20

Passed

Description

28%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.

The outer frontmatter description is auto-generated boilerplate that names the skill and its invocation token but says nothing about what the skill actually does or when to use it — and the file's malformed structure (a second, richer description buried in an embedded frontmatter block in the body) means even the substantive description never surfaces where it would be read. It reads as a wrapper label, not a trigger-optimized skill description.

Suggestions

Replace the boilerplate with a third-person capability statement plus an explicit trigger clause, e.g. 'Predicts market movements and executes low-latency trades using temporal computational analysis. Use when the user asks to predict prices, backtest high-frequency trading strategies, or analyze latency arbitrage opportunities.'

Include natural trigger terms and synonyms users would actually say ('market prediction', 'price forecasting', 'HFT', 'trading strategy') instead of repeating the skill name and the $-invocation token.

Fix the malformed double frontmatter by merging the two blocks into a single valid frontmatter so the substantive description is the one that gets parsed and evaluated.

DimensionReasoningScore

Specificity

The frontmatter description is 'Agent skill for trading-predictor - invoke with $agent-trading-predictor' — it names the domain but describes zero concrete actions, only how to invoke it. This matches the anchor 'Names the domain but actions are minimal or generic' (like 'Processes PDF files'); it is not level 1 because the domain is named, and not level 3 because no actual capability (predict, analyze, trade) is stated.

2 / 5

Completeness

The 'what' is limited to a generic boilerplate label ('Agent skill for trading-predictor') and the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which also caps this dimension at 3 per the guidelines. This matches the anchor 'has a vague what and no when'; it is not level 3 because even the 'what' fails to state any concrete capability.

2 / 5

Trigger Term Quality

The only keywords are the repeated skill name 'trading-predictor' and the invocation token '$agent-trading-predictor' — technical identifiers rather than the natural phrases a user would say (e.g. 'predict market movements', 'backtest a strategy'). This fits 'one or two generic keywords; missing the natural phrases users say'; it is above level 1 only because 'trading' and 'predictor' gesture at the domain.

2 / 5

Distinctiveness Conflict Risk

The trading-prediction niche is fairly specific, so it is unlikely to collide with unrelated skills, but the boilerplate phrasing ('Agent skill for X') carries no discriminating triggers and would compete with any other trading or prediction skill. This fits 'somewhat specific but could still overlap with similar skills'; it is not level 4 because nothing in the description distinguishes it from sibling agent skills beyond the name.

3 / 5

Total

9

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ruvnet/ruflo
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.