CtrlK
BlogDocsLog inGet started
Tessl Logo

trader-memory-core

Track investment theses across their lifecycle — from screening idea to closed position with postmortem. Register theses from screener outputs, manage state transitions, attach position sizing, review due dates, and generate postmortem reports with P&L and MAE/MFE analysis. Trigger when user says "register thesis", "track this idea", "thesis status", "review due", "close position", "postmortem", or "trading journal".

72

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 highly actionable, well-structured CLI skill document: every lifecycle operation has executable commands, explicit invariants, and failure-mode handling, with clean one-level references. The deductions are minor — some rationale/troubleshooting text could be trimmed or moved to references, verification steps are implicit in tool errors rather than explicit checkpoints, and two bundle pointers (unreferenced postmortem template, missing schema path) need cleanup.

Suggestions

Use the full script path (or a single defined short variable) consistently instead of the ".../trader_memory_cli.py" abbreviation scattered through the Update section, so every example is literally copy-paste runnable.

Fix the Resources section: either reference assets/postmortem_template.md where postmortems are described, and correct/remove the schemas/thesis.schema.json pointer (no schemas/ directory exists in the skill bundle — if it lives at repo root, say so explicitly).

Tighten or relocate the dependency-fallback ladder and the futures re-attach-guard rationale into references/ so the main workflow stays lean, and add an explicit post-transition verification step (e.g., re-run `store ... list --status` to confirm) to the Update workflow.

DimensionReasoningScore

Conciseness

The body is dense with operational content — fail-closed ingest rules, fractional-share bounds, backdating semantics, futures P&L formula — with no explanation of concepts Claude already knows. However, sections like the uv-install fallback ladder and the rationale for the futures re-attach guard ("would silently overwrite the entire position dict including direction, flipping the sign...") run longer than needed to instruct, fitting the 4-anchor ('efficient; minor instances of over-explanation') rather than the 5-anchor where every token earns its place.

4 / 5

Actionability

Nearly every operation ships a complete, executable command with real flags and values (e.g., "transition <id> ENTRY_READY --reason \"validated\" [--event-date YYYY-MM-DD]", the open-position/trim/close sequence, a full manual-ingest JSON example) plus Python API equivalents and a prioritized error-recovery path for a missing dependency. This matches the 5-anchor's copy-paste-ready commands covering the common cases; the occasional ".../trader_memory_cli.py" abbreviation is defined by the earlier full invocation and is not a real gap.

5 / 5

Workflow Clarity

The five-phase workflow (Register → Query → Update → Review → Postmortem) is clearly sequenced with explicit state invariants (ACTIVE ⇒ shares_remaining == shares) and validation embedded in the tools (schema validation at save time, fail-closed verdict filtering, NO_TRADE report rejection), plus a fix-and-retry loop for the missing-dependency case. It falls short of the 5-anchor because post-operation verification is delegated to CLI errors rather than stated as explicit checkpoints (e.g., no 'confirm with list/status after transition' step), matching the 4-anchor's 'most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

Good structure against the actual bundle: the Resources section clearly signals one-level-deep references (references/thesis_lifecycle.md, references/field_mapping.md — both real files), and the workflow sections stay operational rather than inlining reference material. Minor gaps keep it at the 4-anchor: assets/postmortem_template.md exists in the bundle but is never referenced from SKILL.md, and the listed schemas/thesis.schema.json does not exist in the skill bundle, so that pointer is broken as written.

4 / 5

Total

17

/

20

Passed

Description

96%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: concrete, comprehensive action coverage in third person, with an explicit and well-chosen set of natural trigger phrases. The only weakness is slight trigger overlap with adjacent trading skills in the same suite (e.g., "review due", "close position").

DimensionReasoningScore

Specificity

The description enumerates multiple concrete, comprehensive actions spanning the full lifecycle: "Register theses from screener outputs, manage state transitions, attach position sizing, review due dates, and generate postmortem reports with P&L and MAE/MFE analysis". It matches the 5-anchor's comprehensive multi-action coverage; the 4-anchor would require minor gaps in coverage, which are not present.

5 / 5

Completeness

Both questions are explicitly answered: 'what' via the concrete action list, and 'when' via an explicit trigger clause ("Trigger when user says..."). This mirrors the 5-anchor exemplar's structure of concrete actions plus explicit trigger phrases; a 'Use when' clause is present, so no cap applies.

5 / 5

Trigger Term Quality

Seven natural, user-sayable trigger phrases are quoted verbatim: "register thesis", "track this idea", "thesis status", "review due", "close position", "postmortem", "trading journal" — covering synonyms across the lifecycle (journal/postmortem, track/register). All are phrases a user would naturally say, matching the 5-anchor's comprehensive natural-term coverage rather than the 4-anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The domain (investment thesis lifecycle tracking, MAE/MFE postmortems) is a clear niche with distinctive triggers like "register thesis" and "postmortem". However, phrases like "review due" and "close position" have minor overlap risk with the closely related screeners/review-monitor skills this skill is designed to sit alongside, fitting the 4-anchor ('mostly distinct; minor overlap risk with closely related skills') better than the 5-anchor's minimal-conflict bar.

4 / 5

Total

19

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.