trade-journal

trade-journal is a skill for Claude Code, Codex from realnaka/alphaloop. It costs 198 tokens per session (1,605 once invoked), scanned A, original, MIT.

A trade journal records each investment or sale in a structured table. It can take details from a broker screenshot or your description, including the asset, action, quantity, price, date, account, and reason.

In plain words
What is it for?
Use it to record buys, sells, position increases or reductions, and closed positions in a local CSV or Markdown file, with optional cloud-table storage. It can also link each trade to an investment explanation and later profit-and-loss tracking.
Why use it?
It prevents trade details from being scattered across screenshots and messages or guessed when an image is unclear. Keeping a separate log also avoids changing your existing holdings table.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is **接线**:归因/落档走 [`openorder`](../openorder/SKILL.md);现价算盈亏走 [`stock-data-fetch`](../stock-data-fetch/SKILL.md);截图数字不臆造走 [`claim-verification`](../claim-verificati.

Good fit Use it to record buys, sells, position increases or reductions, and closed positions in a local CSV or Markdown file, with optional cloud-table storage. It can also link each trade to an investment explanation and later profit-and-loss tracking.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/realnaka/alphaloop
agentmods
npx agentmods add skills/realnaka/alphaloop/trade-journal

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for trade-journal

README.md
[![agentmods](https://agentmods.dev/badge/skills/realnaka/alphaloop/trade-journal/github.svg)](https://agentmods.dev/skills/realnaka/alphaloop/trade-journal)
Your own site
<a href="https://agentmods.dev/skills/realnaka/alphaloop/trade-journal"><img src="https://agentmods.dev/badge/skills/realnaka/alphaloop/trade-journal/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for trade-journal

Your own site · 80×15
<a href="https://agentmods.dev/skills/realnaka/alphaloop/trade-journal"><img src="https://agentmods.dev/badge/skills/realnaka/alphaloop/trade-journal.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 198 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,605 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00198 $0.01605
Opus 5 $0.00099 $0.00803
Sonnet 5 $0.00040 $0.00321
Haiku 4.5 $0.00020 $0.00161

Measured 10d ago against content hash f25479647be9, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

trade-journal scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/trade-journal/SKILL.md · 84 lines

How it starts

The opening of the file, as written. The whole thing — 84 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Trade Journal(交易日志:截图/口述 → 结构化录入)

目的:把"建仓即记"变成习惯——每笔交易记下成本价 + 建仓日 + 来源框架,让 openorder thesis-ledger.md 的盈亏栏能自动回填、框架命中率自然累积。这是闭合「分析→建仓→盈亏→校准」环最缺的一步。 接线:归因/落档走 openorder;现价算盈亏走 stock-data-fetch;截图数字不臆造走 claim-verification(看不清的标 ⚠️,不编)。 铁律:交易写入独立的交易日志表,绝不写用户原有的展示/持仓表,避免污染既有结构与数字。

存储后端(默认本地,云端可选)

为了让任何人开箱即用,默认把交易日志存成本地文件,云端表格是可选适配器:

后端 路径 / 配置 适用
本地 CSV(默认) ${TRADE_JOURNAL:-$HOME/openorder/trade-journal.csv} 零依赖,纯文本,git 可追踪
本地 Markdown 表 ${OPENORDER_HOME:-$HOME/openorder}/trade-journal.md 想跟 openorder wiki 放一起、用 Obsidian 浏览
云端表格(可选) 飞书/Google Sheets/Notion 等,token 放环境变量,不要硬编码进本仓库 多端同步 / 团队共享

用云端表格时,把 spreadsheet token、sheet_id 等放进你自己的环境变量或本地配置(如 ~/.config/trade-journal/config),永远不要把私有 token 提交到任何公共仓库

表头(统一列结构,CSV/表格通用)

日期,账户,标的,方向,股数,成本价,货币,金额,来源框架,thesis-id,备注
字段 说明
日期 成交日 YYYY-MM-DD
账户 券商/钱包名 FUTU/Tiger/IBKR/Wallet…
标的 ticker 或中文名
方向 买 / 卖 / 加仓 / 减仓 / 平仓
股数 数量
成本价 成交单价
货币 USD/CNY/HKD…
金额 股数×成本价(本币)
来源框架 framework:{id} / 直觉 / 消息 / 未归因 每笔必确认
thesis-id 关联 openorder thesis-ledger 的 ID 可空
备注 截图看不清/存疑的标注在此

录入工作流

1. 读输入(截图用 Read 读图 / 口述直接取)
   → 抽取每笔:日期、账户、标的、方向、股数、成本价、货币
   → 看不清的字段标 ⚠️,向用户确认,绝不臆造(claim-verification 纪律)

2. 逐笔确认「来源框架」(关键人机边界,必须问)
   → 这笔是哪个框架/thesis 驱动的?还是直觉/消息/未归因?
   → 这是把人的判断变成可复利训练信号的入口,不能省

3. 追加到交易日志表(仅此独立表,不碰原始持仓表)
   → 本地 CSV:按表头顺序 append 一行(多笔批量);首次创建先写表头
   → 云端表格:用对应 CLI/API append;写前先确认表结构与 sheet_id
     (注意各家 append API 的 range 行数必须 ≥ 要写的行数)

4. 联动 openorder(归因闭环)
   → 框架驱动的建仓:在 thesis-ledger 对应/新建 thesis,回填 头寸=framework:X + 成本 + 建仓日
   → 未归因的:标 直觉/消息,列入复盘提醒
   → 追加 openorder log(action=decision)

5. 回执
   → 列出记了哪几笔、来源框架、写到表的第几行;ASK 是否要据此更新持仓敞口

盈亏计算(查询时)

要看盈亏时:从交易日志取成本,用 stock-data-fetch 取现价(标时间+源),盈亏 = (现价−成本价)×股数铁律:框架对错(thesis 结果)与头寸盈亏分开记分,不用单笔盈亏给框架定生死(见 openorder frameworks/outcome-tracking.md)。

Read the full file on GitHub · 84 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 84 lines · 198 tokens per session scan A f25479647be9

Subscribe to this mod's changes

trade-journal is a skill published in the GitHub repository realnaka/alphaloop (19 stars, last pushed 2mo ago), licensed MIT. It adds 198 tokens to every session and 1,605 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

app-store-pricing

App Store pricing strategy, global equalization, subscription management, and regional pricing decisions using Apple's official 900-price-point system. Use when user asks about pricing tiers, IAP pricing, subscription pricing, regional pricing, price changes, App Store proceeds, base storefront selection, introductory…

markdavidgan/apple-dev-skills · 66 tokens

justfix

Use this skill when the user asks for a quote, estimate, price, or "how much" for a UK trades job – electrical, plumbing, locksmith, glazing, carpentry, handyperson, heating, gas, roofing, drains, white goods, or boiler service. Calls the JustFix Estimator MCP server to return a cost breakdown, scope summary, and a…

Just-Fix/justfix-skill · 90 tokens

alpha-vantage

Access real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API. Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market…

foryourhealth111-pixel/Vibe-Skills · 126 tokens

asc-ppp-pricing

Set territory-specific pricing for subscriptions and in-app purchases using current asc setup, pricing summary, price import, and price schedule commands. Use when adjusting prices by country or implementing localized PPP strategies.

rorkai/app-store-connect-cli-skills · 45 tokens

roblox-input

Use when handling Roblox keyboard, mouse, gamepad, touch, motion input, or cross-platform action binding.

TabooHarmony/roblox-brain · 26 tokens

roblox-performance

Use when profiling Roblox performance or diagnosing FPS, memory, network, mobile, or hot-path problems.

TabooHarmony/roblox-brain · 24 tokens