CtrlK
BlogDocsLog inGet started
Tessl Logo

quantum-position-engine

Quantum Position Engine 仓位计算引擎指南。覆盖 Decimal 精度计算、跨币种汇率换算、保证金杠杆检查、回撤熔断等核心风控逻辑。当需要计算仓位、检查风控参数、调试仓位引擎时使用此 Skill。

86

Quality

82%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

85%

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

This is a well-crafted skill description that clearly defines a specialized trading/risk management position calculation engine. It excels at specificity with concrete technical capabilities and includes an explicit 'when to use' clause. The main weakness is that trigger terms are quite technical, which may not match how less technical users would phrase their requests.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Decimal 精度计算、跨币种汇率换算、保证金杠杆检查、回撤熔断' (Decimal precision calculation, cross-currency exchange rate conversion, margin leverage checking, drawdown circuit breaker). These are concrete, technical capabilities.

3 / 3

Completeness

Clearly answers both what ('Decimal 精度计算、跨币种汇率换算、保证金杠杆检查、回撤熔断等核心风控逻辑') and when ('当需要计算仓位、检查风控参数、调试仓位引擎时使用此 Skill'). Has explicit 'Use when' equivalent clause with specific trigger scenarios.

3 / 3

Trigger Term Quality

Contains domain-specific terms like '仓位计算' (position calculation), '风控' (risk control), '杠杆' (leverage), '保证金' (margin), but these are somewhat technical. Missing common variations or simpler user-facing terms that non-experts might use.

2 / 3

Distinctiveness Conflict Risk

Very specific niche: quantum position engine with trading/risk control focus. Terms like '仓位引擎', '保证金杠杆', '回撤熔断' are highly distinctive and unlikely to conflict with general coding or document skills.

3 / 3

Total

11

/

12

Passed

Implementation

79%

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

This is a well-structured, concise skill that provides actionable guidance for using the position calculation engine. The content efficiently uses tables and code examples to convey complex information. Main weaknesses are the lack of explicit validation/debugging workflows and missing links to referenced source files or extended documentation.

Suggestions

Add a troubleshooting section with validation steps for common issues (e.g., unexpected zero position, margin降级 scenarios)

Include links to the referenced source files (models.py, calculator.py, etc.) or create a REFERENCE.md for API details

Add an error handling example showing how to interpret and respond to BLOCKED results or margin adjustments

DimensionReasoningScore

Conciseness

The content is lean and efficient, using tables and code blocks to convey information densely. No unnecessary explanations of concepts Claude already knows (like what Decimal is or why floating point has errors).

3 / 3

Actionability

Provides fully executable Python code example with proper imports, concrete parameter values, and expected output format. The calculation flow is specific with exact formulas, and all input parameters are clearly documented.

3 / 3

Workflow Clarity

The 7-step calculation flow is clearly sequenced with decision points (熔断检查, 保证金检查), but lacks explicit validation/verification steps for debugging or error recovery. No feedback loop for when calculations produce unexpected results.

2 / 3

Progressive Disclosure

Good use of sections and tables for organization, but the architecture section references files (models.py, calculator.py, etc.) without linking to them. Could benefit from explicit links to detailed documentation for advanced topics like custom asset types or汇率服务 configuration.

2 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
Lingjie-chen/MT5
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.