CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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".

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

75%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-sequenced operational guide with real commands for every lifecycle path including futures and manual fractional-share entry. Its weaknesses are density and placement: large changelog-flavored policy paragraphs sit in Prerequisites instead of a reference file, two referenced bundle paths are dangling, and one lifecycle operation lacks a CLI example.

Suggestions

Move the long-only/short-rejection and initial-stop validation paragraphs out of Prerequisites into a dedicated reference file (or a clearly labeled policy section), rewriting changelog phrasing like "remain compatible" and "rejected before they can be discarded" as direct instructions.

Add a CLI example for mark_reviewed (the only lifecycle operation shown Python-only) and a quick verification step after mutating operations, e.g. `store --state-dir state/theses/ list --ticker AMD --status ACTIVE`.

Fix the Resources section: `schemas/thesis.schema.json` and `../../examples/workflows/trade-memory-loop/sample-run-full-path/` are absent from the bundle, and `assets/postmortem_template.md` is never referenced — either add/reference these files or remove the dangling paths.

DimensionReasoningScore

Conciseness

Mostly efficient — command blocks pair with tight explanations and no space is spent on concepts Claude already knows — but the ~30-line long-only/short-policy and initial-stop paragraphs ("Explicit SHORT directions are rejected before they can be discarded…", "Absent optional pairs and existing finite nonpositive-price behavior remain compatible") are changelog-style, hard to parse, and sit inline in Prerequisites where reference-level detail belongs; "Phase 1 supports single-ticker theses" is also repeated in both Overview and Key Principles. This fits "mostly efficient but includes some unnecessary explanation or could be tightened" rather than the minor-trim anchor at 4.

3 / 5

Actionability

Every lifecycle operation has a concrete, runnable command with real flags (ingest, transition, open-position, trim, close/terminate, review-due, postmortem, summary), plus a complete manual-ingest JSON example, the backdated three-step sequence for an already-open position, futures variants, and a documented Python API (get/validate_thesis). The few `python3 .../trader_memory_cli.py` abbreviations are obvious shorthand after the full path is shown twice, so examples are effectively copy-paste ready and cover the common cases.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (Register → Query → Update → Review → Postmortem) with an explicit forward-only state machine, per-status invariants (e.g. "ACTIVE ⇒ shares_remaining == shares"), fail-closed ingest rules, and a prioritized dependency-recovery loop for the launcher ("Install uv and re-run"). It falls short of 5 because verification is described as built-in tool behavior rather than explicit workflow steps (no post-transition confirm command), and `mark_reviewed` — uniquely among lifecycle operations — has no CLI example, only the Python signature.

4 / 5

Progressive Disclosure

Good structure overall: a Resources section clearly signals one-level-deep references (`references/thesis_lifecycle.md`, `references/field_mapping.md`) that genuinely exist and hold the deep material (state tables, field mappings), and the body is sectioned by workflow stage. Minor gaps keep it from 5: the referenced `schemas/thesis.schema.json` and `../../examples/workflows/…` path do not exist in the skill bundle, and `assets/postmortem_template.md` is never referenced from SKILL.md, while the dense short-policy prose that could live in a reference is inlined.

4 / 5

Total

16

/

20

Passed

Description

88%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 covers what the skill does across its whole lifecycle and gives a literal spoken-trigger list. The only weaknesses are a few missing natural synonyms for journaling actions and the mild cross-domain ambiguity of the standalone word "postmortem". Third-person voice is used consistently, so no voice penalty applies.

DimensionReasoningScore

Specificity

The description lists five concrete, comprehensive actions — "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" — covering the full lifecycle the skill supports. This matches the anchor for multiple specific concrete actions with comprehensive coverage; it is not score 4 because there are no meaningful coverage gaps.

5 / 5

Completeness

Both halves are explicit: the "what" is the full lifecycle action list, and the "when" is a literal trigger clause — "Trigger when user says 'register thesis', 'track this idea', … or 'trading journal'". This directly matches the anchor for clearly and explicitly answering both what AND when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Explicit natural phrases are quoted ("register thesis", "track this idea", "thesis status", "review due", "close position", "postmortem", "trading journal") that users would plausibly say verbatim. It falls short of the comprehensive anchor because common synonyms such as "log this trade", "record this trade", or "position tracker" are missing.

4 / 5

Distinctiveness Conflict Risk

The niche (investment thesis lifecycle and trading journal) is clear and triggers like "thesis status" and "trading journal" are highly distinctive. However, "postmortem" is a term users also say in software/incident contexts, creating minor overlap risk with unrelated skills, which fits the "mostly distinct; minor overlap risk" anchor rather than minimal conflict risk.

4 / 5

Total

18

/

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

tradermonty/claude-trading-skills

Path

skills/trader-memory-core/SKILL.md

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.