Skip to main content

trade-strategy

Write a long-form trading strategy document — thesis, entry triggers, exit rules, position sizing, hold horizon, kill criteria. No trade is fired. Saves a structured markdown note to ~/.blockrun/notes/. Use when the user wants to plan an approach before committing capital.

Source facts

Repository
BlockRunAI/Franklin
Last source activity
May 17, 2026 at 13:46
Detected SKILL.md language
English
Stars
555
Forks
54

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
trade-strategy
description
Write a long-form trading strategy document — thesis, entry triggers, exit rules, position sizing, hold horizon, kill criteria. No trade is fired. Saves a structured markdown note to ~/.blockrun/notes/. Use when the user wants to plan an approach before committing capital.
triggers
["trading strategy","write a strategy","strategy doc","trade plan","planning a trade"]
argument-hint
<topic or thesis>
cost-receipt
false
You are running inside Franklin on **{{wallet_chain}}**. This skill captures *intent* before *action*. The user wants a written strategy, not an executed trade. Result: a markdown file under `~/.blockrun/notes/` that the user (and future Franklin sessions) can reference when the actual trade fires via `/trade-signal`. ## Workflow 1. **Clarify if needed.** If the argument is just a ticker ("BTC") without a direction, ask one clarifying question about what the user is trying to do (long, short, range, event-driven). 2. **Gather supporting context.** Use the `/surf-market`, `/surf-chain`, or `/surf-social` skills to pull data that informs the strategy. Each surfaces its own cost; mention what you spent at the end. 3. **Write the strategy doc.** Use the `Write` tool to create: - Path: `~/.blockrun/notes/<YYYY-MM-DD>-<slug>-strategy.md` (replace `~` with the user's actual home dir; ask if you don't know it, or run `Bash("echo $HOME")` once) - Slug: short kebab-case identifier derived from the topic (e.g. `btc-pre-halving-long`) - Content template: ```markdown # Strategy — <Title> **Date:** <YYYY-MM-DD> **Author:** Franklin (skill: /trade-strategy) **Status:** draft ## Thesis <2–4 paragraphs: why this trade now. Cite the data sources you pulled.> ## Symbols & direction - Primary: <SYMBOL> <long|short> - Hedges (if any): <SYMBOL> <long|short> ## Entry triggers - <Specific price levels, indicator readings, or events that must hold> - <…> ## Position sizing - Per-symbol notional cap: $<N> (vs Franklin's $400 default) - Conviction tier: <1–5> — justification: <…> ## Exit rules - Take profit: <price | indicator | event> - Stop loss: <price | indicator | event> - Time stop: exit by <date / horizon> regardless ## Kill criteria What invalidates the entire thesis? (Be specific — name a level, a metric, or a market regime change.) ## Evidence - <source 1> - <source 2> - <indicator reading> ## Tags `<momentum>` `<macro>` `<event>` (etc.) ## Linked trades (Populated as `/trade-signal` invocations reference this doc.) ``` 4. **Confirm the path.** Report back to the user: "Strategy saved to `<path>`. Open it with your editor or pull it into your next `/trade-signal` call as context. Discipline score on the strategy is captured when the first trade fires." 5. **Do not call `TradingOpenPosition`.** This skill is plan-only. The user fires the trade separately via `/trade-signal` when ready. ## Anti-patterns - Skipping kill criteria. Every strategy has them; "I'll know when to exit" is not a strategy. - Position sizing without conviction-justified caps. A conviction-2 strategy that loads the full $400 cap is theater. - Writing a strategy doc and immediately firing a trade. The point of separating the two is to force a pause. If the user wants both, run `/trade-strategy` first, then `/trade-signal` referencing the saved file. ## The user said $ARGUMENTS
View on GitHub