Agent skill

Trading Ledger

by sickn33 in sickn33/agentic-awesome-skills

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.

MITAuto-check passedBusiness, Finance & HR

Install Trading Ledger

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill trading-ledger -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills trading-ledger --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/trading-ledger .claude/skills/trading-ledger && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
trading-ledger
GitHub stars
47k
Used in
1 other repo
Token cost
~2.2k tokens
SKILL.md length
1,069 words
Files
1
Skills in repo
1,493
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 4 steps: Confirm the database (first use per… → Opening a trade → Closing or adjusting → …
  • Tasks that involve Trading and backtesting
  • SKILL.md covers Overview, When to Use This Skill, How It Works and Examples, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Trading Ledger is an agent skill from sickn33/agentic-awesome-skills. 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.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Trading and backtesting and Essays and academic help. It works with Notion. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

  • Tasks that involve Trading and backtesting
  • Tasks that involve Essays and academic help

Example prompts

  • “/trading-ledger”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Confirm the database (first use per session)
  2. Opening a trade
  3. Closing or adjusting
  4. Batch reconcile and review

What it can do on your machine

Read from SKILL.md and the folder at commit 680176d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Trading Ledger loads about 2.2k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 1,069 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit 680176d, republished under its MIT licence (© sickn33). 1,069 words, ~2,178 tokens.

Download SKILL.mdSave it as .claude/skills/trading-ledger/SKILL.md (or your agent's skills folder).
name
trading-ledger
description
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.
category
productivity
risk
critical
source
community
source_repo
cruisekkk/trading-ledger
source_type
community
date_added
2026-07-04
author
cruisekkk
tags
trading-journal, notion, journaling, market-wizards, decision-making
tools
claude
license
MIT

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 / Other
  • Direction (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 spot
  • Plan (text) — stop / target / contingency; ask if missing
  • Emotion (select): Calm / FOMO / Panic / Revenge / Boredom / Overconfidence — tag only what the user admits or what is plain in their words; don't diagnose
  • Execution (select): Per plan / Early exit / Delayed stop / Impulse / Unplanned add — filled at close
  • P&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-confirm rows → collect all open questions into one message.
  • "review my trades" → query recent Closed + all Open rows. 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 into Review, move Closed → 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
text
User:  picked up some TSM July calls this morning, same thesis as before earnings
Agent: Logged ✅ TSM July calls · Long · Open
       ❓ To-confirm: which strike/expiry, how many contracts, at what price?
       ❓ And the plan — holding through earnings, or is there a stop?
User:  0731 475C, 1 contract at 18.50, holding to earnings
Agent: Updated ✅ Ticker: TSM 0731C475 · Thesis: pre-earnings run-up · Plan: hold through earnings
Show full SKILL.md (425 more words)Show less
Example 2: Review day
text
User:  review my trades
Agent: 3 closed since last review:
       · NVDA long — thesis played out, exited per plan. Good trade.
       · TSLA short — thesis wrong, but stopped exactly where planned. Good trade, bad outcome.
       · SPY calls — profitable, but Entry was tagged FOMO and there was no plan. Lucky, not good.
       Open positions: TSM call — earnings run-up thesis still holds until the 7/29 print.

Best Practices

  • ✅ Ask for the thesis at entry time — it decays overnight and memory flatters
  • ✅ Grade execution against the user's own plan, never against hindsight
  • ✅ Batch all questions into one message; give a short receipt after logging
  • ❌ Don't compute P&L you are unsure of — options and futures have multipliers; use the user's numbers
  • ❌ Don't invent select values; copy the enum
  • ❌ A review is not a P&L total — it grades thesis and execution

Limitations

  • Requires the user's own Notion workspace, the companion database (duplicate the template from the source repo), and the official Notion connector granted access — connector/skill setups currently live on paid Claude tiers.
  • Close, reconcile, and review flows require reliable Notion database query/search access to open, closed, and To-confirm rows. If the connector cannot query the ledger, stop after logging the user's new facts and ask them to provide the relevant row details instead of guessing matches.
  • No broker integration, by design: the broker knows the fills; only the user knows the reasons. The user must self-report.
  • Grading honesty depends on input honesty: a thesis backfilled three days later defeats the point (the skill nags, but cannot prevent it).

Security & Safety Notes

  • Mutation scope: writes and updates rows only in the exact Notion database ID confirmed by the user for the current session via the official Notion connector (MCP) — no shell commands, no network fetches, no market-data lookups, no credentials.
  • This skill must never produce trading signals, price data, or buy/sell recommendations. It records and mirrors the user's own decisions; the review asks questions, it does not advise. Nothing it writes is financial advice, and it should say so if asked for a recommendation.
  • On claude.ai, Notion's write tools default to needs approval — the first write pops an approval prompt; expected, not a hang.

Common Pitfalls

  • Problem: Notion API 400 on date fields. Solution: Expand to "date:Entry Date:start": "YYYY-MM-DD".
  • Problem: create-pages succeeds but the date column is empty (known Notion MCP issue: notion-mcp-server#121 — expanded date fields silently dropped). Solution: After the session's first create, read the row back; if the date is empty, fill it with update-page.
  • Problem: Close matched to the wrong row when the same ticker was traded twice. Solution: Match on Status=Open + ticker; if multiple open rows match, ask which one.
  • Problem: Overnight US fills dated to the wrong day for non-US users. Solution: Overnight fills belong to the US trading date; confirm the date before writing.
  • @time-ledger - The same "parse plain language → own Notion DB → ask instead of guessing" pattern applied to time tracking.

© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/trading-ledger of sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit 680176d

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Trading Ledger next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Trading Ledger compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trading Ledger this skillsickn33/agentic-awesome-skills47k1 repos~2.2kAutomated safety check: PassMIT
Weekly Trading Planzhu1090093659/dsh-trading234—~2kAutomated safety check: PassCustom licence
Prediction Market Strategyagiprolabs/claude-trading-skills410—~3.4kAutomated safety check: PassMIT
Catalyst ConfirmationSuperior-Trade/superior-skills214—~667Automated safety check: PassMIT
Academy Skillbinance/binance-skills-hub1.1k—~3.5kAutomated safety check: NotesNone
Equity Research Corebyteseek/Mira275—~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Weekly Trading Plan

    zhu1090093659/dsh-trading

    制定每周交易计划:把本周复盘、统一台账持仓与资金、市场消息与公告、facts/ 与知识库、假设档案(hypothesistracking / 持仓 thesis / 宏观管道状态)合成一份下周计划,逐条过六道闸门并给出双向预案与失效条件。当用户要求「制定本周/下周交易计划」「周度作战计划」「把复盘+持仓+消息+知识库合成计划」,或周末例行生成计划时调用。

    234 GitHub stars~2k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Prediction Market Strategy

    agiprolabs/claude-trading-skills

    Venue- and market-type-agnostic strategy, sizing, and backtesting layer for binary prediction markets (Kalshi, Polymarket, ForecastEx).

    410 GitHub stars~3.4k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Catalyst Confirmation

    Superior-Trade/superior-skills

    A skill your agent uses when a Polymarket prediction-market thesis rests on an external event — CPI, Fed, elections, court rulings, ETF decisions — and needs market confirmation before committing.

    214 GitHub stars~667 tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Academy Skill

    binance/binance-skills-hub

    Retrieve Binance Academy's official educational content (Glossary, Courses, Learn & Earn, Articles) for AI chat.

    1.1k GitHub stars~3.5k tokensUpdated 28 days ago
    Business, Finance & HRAuto-check: notes
  • Run Mira's core single-equity research workflow across fundamentals, financial quality, macro context, technical pricing, events, and thesis framing.

    275 GitHub stars~1.9k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Analyze earnings releases, filings, transcripts, guidance, peer comparisons, market reaction, and thesis impact for a company reporting event.

    275 GitHub stars~2.6k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,493 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Works with

Questions about Trading Ledger

What does Trading Ledger do?

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. Trading Ledger is an agent skill from sickn33/agentic-awesome-skills. 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.

When should I use Trading Ledger?

Trading Ledger fits situations like: tasks that involve Trading and backtesting; tasks that involve Essays and academic help.

How do I install Trading Ledger in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill trading-ledger -a claude-code`. Or copy the skill folder (skills/trading-ledger in sickn33/agentic-awesome-skills) into .claude/skills/trading-ledger in your project. Claude Code loads it when a task matches its description.

How do I install Trading Ledger in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill trading-ledger -a codex`. Or copy the skill folder (skills/trading-ledger in sickn33/agentic-awesome-skills) into .agents/skills/trading-ledger in your project. Codex loads it when a task matches its description.

Can I use Trading Ledger in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill trading-ledger -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trading-ledger, .gemini/skills/trading-ledger, .github/skills/trading-ledger and .opencode/skills/trading-ledger in your project.

What does Trading Ledger need to run?

SKILL.md names no scripts, command-line tools or credentials: Trading Ledger is instructions for the agent only.

Does Trading Ledger access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Trading Ledger safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Trading Ledger use?

Trading Ledger is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Trading Ledger use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Trading Ledger?

Skills that share tags, products or a category with Trading Ledger: Weekly Trading Plan (zhu1090093659/dsh-trading, 234 stars), Prediction Market Strategy (agiprolabs/claude-trading-skills, 410 stars), Catalyst Confirmation (Superior-Trade/superior-skills, 214 stars) and Academy Skill (binance/binance-skills-hub, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trading Ledger?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,379 GitHub stars. The repository holds 1,493 skills in this directory. The repository was last updated on October 9, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.