trader-memory-core

Track investment theses through lifecycle states with YAML persistence and P&L computation.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/dnkrow/skill --skill trader-memory-core-dnkrow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trader-memory-core
Source: https://github.com/dnkrow/skill/tree/main/claude-global/trader-memory-core
Command: npx skills add https://github.com/dnkrow/skill --skill trader-memory-core-dnkrow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, jsonschema, urllib, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill solves the problem of losing track of your investment theses across screening, execution, and post-trade learning by maintaining a persistent, structured “thesis object” per idea.

Core Features & Use Cases

  • Lifecycle state management: Ingest a thesis from screener output, validate it, move it forward through IDEA → ENTRY_READY → ACTIVE → CLOSED/INVALIDATED, and keep status history and review cadence.
  • Portfolio-ready thesis records: Attach position sizing outputs (shares-based) and link related reports so every thesis has the evidence you relied on.
  • Review + postmortem with performance analytics: Generate postmortems (including MAE/MFE via FMP EOD prices when available) and compute summary statistics like win rate and average P&L%.

Quick Start

Register a thesis by running:
You say: register a thesis from a kanchi-dividend-sop JSON report into state/theses.

Frequently Asked Questions about trader-memory-core

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track an investment thesis from screening through to a closed-position postmortem?

You track investment theses by ingesting JSON candidate tickers into a persistent YAML state file, enforcing forward-only lifecycle transitions like IDEA to ACTIVE to CLOSED, and generating postmortems with computed P&L. This maintains a structured thesis record per idea.

Can I compute MAE and MFE excursion metrics for my trading journal using EOD price data?

Yes, trading journal excursion metrics are computed by optionally fetching FMP EOD prices during the postmortem phase. This retrieves Maximum Adverse Excursion and Maximum Favorable Excursion data for closed positions when end-of-day pricing is available.

How do I attach shares-based position sizing to a single-ticker trading workflow?

Shares-based position sizing is attached during the ENTRY_READY lifecycle state transition. The system links your sizing outputs directly to the persistent thesis object, ensuring every active trade record contains the evidence and share quantities relied upon for execution.

Does the state machine enforce forward-only lifecycle transitions for investment thesis records?

Yes, the state machine enforces forward-only lifecycle transitions across IDEA, ENTRY_READY, ACTIVE, CLOSED, and INVALIDATED states. This prevents backward status changes and maintains strict status history alongside scheduled review cadence using atomic YAML writes.

What is the best way to schedule trade reviews by due date within a YAML persistent state file?

Scheduling trade reviews by due date is handled within the YAML persistent state file during thesis registration. The system records the review cadence and due dates alongside status history, applying atomic writes to both the state file and index.

Do I need screener output in JSON format to register a new thesis candidate?

Yes, ingesting screener output as JSON is required to register a new thesis candidate into the state. The system validates the JSON report, extracts the single-ticker candidate, and initializes the lifecycle state machine from the IDEA phase.