trading-ledger
Helps your agent record trading decisions and emotions in a journal. Allows analyzing and improving your investment strategies.
What it does
This agent helps you record your stock or asset trades. It saves not just what you bought or sold, but also your decision's reason, your plan, and your emotions at the time.
When to use it
- ✓When you make a trade (buy or sell an asset).
- ✓When you want to log your trades in detail.
- ✓When you want to review your past investment decisions.
Example of what to ask your AI
“Log the purchase of 100 shares of AAPL at $150, stop at $145, betting on a rise after the earnings report.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You describe your trade, and the agent saves the details in your personal Notion database. It focuses on understanding your strategy and emotions, not just profit or loss.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill trading-ledgerOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/trading-ledger/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Trading Ledger
Overview
A journaling skill in the tradition of the Market Wizards interviews: a written record of every trade's decision process, reviewed on a schedule. The user reports a trade in plain language — "bought 500 NVDA at 135, stop at 128, betting the post-earnings dip fills" — and the agent writes ticker, size, and price to the user's own Notion database plus the part every spreadsheet journal loses: the thesis, the plan, and the emotion. If no reason is stated, it asks on the spot, because entry reasons decay overnight. Reviews grade decision quality against the user's own plan — a per-plan loss scores better than a lucky win. Core contract: never fabricate when unsure; mark To-confirm and batch-ask.
When to Use This Skill
- Use when the user reports a trade fill ("bought 500 NVDA at 135", "closed my TSLA position", "opened 2 ES contracts short")
- Use when the user says "log a trade" or "trading ledger", or "tidy up my trading ledger"
- Use when the user asks to "review my trades"
How It Works
Step 1: Confirm the database (first use per session)
Use Notion search to find candidate databases (type database, not pages) whose title
contains "trading-ledger". Before any query or create-pages call, show the user the
candidate title and data_source_id (collection://... UUID) and ask them to confirm the exact
database for this session. A single title match is not sufficient confirmation. If the connector
returns owner or schema metadata, show it as an additional identity check. Use only the
user-confirmed ID for the remainder of the session; do not re-run fuzzy selection after a
confirmation.
The companion Notion template (free, linked in the source repo) ships this schema — select values are a controlled enum, copy them exactly:
Entry(title);Ticker(text — strikes/expiries here: NVDA / NVDA 0620C150 / ESU6)Market(select): US Stocks / US Options / US Futures / A-Shares / HK Stocks / CN Futures / Crypto / OtherDirection(select): Long / Short ·Size(text, with units)Entry Price/Exit Price(number) ·Entry Date/Exit Date(date — expand to"date:Entry Date:start": "YYYY-MM-DD"; a bare value fails with HTTP 400)Thesis(text) — the soul of the journal; if missing, ask on the spotPlan(text) — stop / target / contingency; ask if missingEmotion(select): Calm / FOMO / Panic / Revenge / Boredom / Overconfidence — tag only what the user admits or what is plain in their words; don't diagnoseExecution(select): Per plan / Early exit / Delayed stop / Impulse / Unplanned add — filled at closeP&L(number, realized) ·Status(select): Open / Closed / To-confirm / Reviewed ·Review(text) ·Notes(text)
Step 2: Opening a trade
Parse → create a row with Status=Open. A missing thesis is the one field worth interrupting for — ask immediately. Anything else uncertain: record what you have, put the question in Notes, mark To-confirm.
Step 3: Closing or adjusting
Find that ticker's Status=Open row → fill Exit Price / Exit Date / P&L / Execution → set Closed. Grade Execution against the user's own Plan: stopped where planned = Per plan; ran before the target = Early exit; held through the stop = Delayed stop. No matching open row → create one marked To-confirm and ask whether the entry was never logged.
Step 4: Batch reconcile and review
- "tidy up my trading ledger" → query
Status=To-confirmrows → collect all open questions into one message. - "review my trades" → query recent
Closed+ allOpenrows. For each closed trade, three questions: Did the thesis play out? (wrong thesis + profit = luck — say so). How was the execution? (a per-plan loss is a good trade). What share of trades were emotion-tagged? Write conclusions intoReview, moveClosed→Reviewed, and for every open position ask: does the entry thesis still hold today?
Parsing rules: infer Market from symbol and context (ambiguous → ask); bought put = Short exposure + note it is a long put; record only given prices/sizes — never look up market prices to fill gaps; "today" = the user's local trading date — confirm before writing.
Examples
Example 1: Opening with a missing plan
User: picked up some TSM July calls this morning, same thesis as before earnings
Agent: Logged ✅ TSM July calls · Long · Open
…
FAQ
What is the 'thesis'?
It's the main reason or your bet behind that specific trade. Why did you decide to buy or sell at that moment?
How does it know where to save the information?
It asks you to confirm which database in your Notion to use. You need to have a specific database template set up beforehand.
Does it calculate my profit or loss?
It can record profit or loss if you provide it, but its main focus is analyzing the quality of your decision and strategy, not just the financial outcome.
Details
Original description by the author
A trading journal that captures the decision, not just the fill: thesis, plan, and emotion at the moment of entry, written to the user's own Notion database; reviews grade decisions, not P&L.
Popularity
- GitHub stars
- 48k
- Ranking position
- #4399
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
intent-driven-development
Helps your agent turn ideas into clear, testable plans. Defines criteria to ensure changes are made correctly and safely.
affaan-m/ECC
product-capability
Guides your agent in turning product ideas into clear plans. It defines what needs to be done, the limits, and decisions before development.
affaan-m/ECC
article-writing
Writes long-form content like articles, guides, and blog posts with a unique style. It's useful when you need well-written texts with a consistent voice and credibility.
affaan-m/ECC