A skill your agent uses when writing, validating, or troubleshooting a recurring scheduled buy strategy (DCA, dollar-cost averaging, weekly buys, daily buys, monthly accumulation, accumulator) on…

MITAuto-check passedBusiness, Finance & HR

Install Dca Weekly

skills CLI
$ npx skills add Superior-Trade/superior-skills --skill dca-weekly -a claude-code

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

GitHub CLI
$ gh skill install Superior-Trade/superior-skills dca-weekly --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/Superior-Trade/superior-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dca-weekly .claude/skills/dca-weekly && 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
dca-weekly
GitHub stars
214
Token cost
~2k tokens
SKILL.md length
539 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing, validating, or troubleshooting a recurring scheduled buy strategy (DCA, dollar-cost averaging, weekly buys, daily buys, monthly accumulation, accumulator) on…

  • Works in 5 steps: No position_adjustment_enable. Without… → No same-day guard in… → Forgetting to scale stake_amount.… → …
  • Troubleshooting a recurring scheduled buy strategy (DCA
  • SKILL.md covers When to use, What it does, Backtest reference and The Freqtrade primitives that…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dca Weekly is an agent skill from Superior-Trade/superior-skills. Use when writing, validating, or troubleshooting a recurring scheduled buy strategy (DCA, dollar-cost averaging, weekly buys, daily buys, monthly accumulation, accumulator) on Superior Trade — especially anything that should "buy more of the same pair" on a calendar trigger rather than a price trigger.

Its SKILL.md is about 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. The repository describes itself as: Open agent skills and tool schemas for Superior Trade — build, backtest, and deploy trading strategies on Hyperliquid. The licence is MIT.

When your agent uses it

  • Troubleshooting a recurring scheduled buy strategy (DCA
  • Dollar-cost averaging
  • Monthly accumulation
  • Accumulator) on Superior Trade — especially anything that should buy more of the same pair on a calendar trigger rather than a price trigger

Example prompts

  • “buy more of the same pair”
  • “/dca-weekly”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. No position_adjustment_enable. Without it, repeat Monday flags are silently rejected and you get one trade ever. The classic v1 mistake.
  2. No same-day guard in adjust_trade_position. Without the filled[-1].order_filled_utc.date() == current_time.date() check, the strategy…
  3. Forgetting to scale stake_amount. Without custom_stake_amount returning proposed_stake / max_dca_multiplier, the first buy uses the full…
  4. Using populate_exit_trend to "exit half". Doesn't work — Freqtrade only knows full exits via populate_exit_trend. Partial exits go through…
  5. Setting stoploss ≥ -0.5. A real DCA isn't supposed to stop out on a 50% drawdown. Use -0.99 so the stop never triggers, then exit manually…

What it can do on your machine

Read from SKILL.md and the folder at commit 9d41db5. 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 (its code samples are python and json).

    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):

    • freqtrade.io
    • 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

Dca Weekly loads about 2k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 539 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~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 Superior-Trade/superior-skills at commit 9d41db5, republished under its MIT licence (© Superior-Trade). 539 words, ~1,990 tokens.

Download SKILL.mdSave it as .claude/skills/dca-weekly/SKILL.md (or your agent's skills folder).
name
dca-weekly
description
Use when writing, validating, or troubleshooting a recurring scheduled buy strategy (DCA, dollar-cost averaging, weekly buys, daily buys, monthly accumulation, accumulator) on Superior Trade — especially anything that should "buy more of the same pair" on a calendar trigger rather than a price trigger.
metadata.version
0.1.0
metadata.updated
2026-05-07

Strategy: DCA · Scheduled Buys

When to use

A user asks to "buy X every week", "DCA into BTC", "scheduled buy", "accumulator", "monthly buy", or any variation that means open a position once, then keep adding to it on a calendar cadence. Not for "buy when price drops" — that's grid trading (see grid-trading).

What it does

  • Holds one open trade per pair (Freqtrade's hard rule).
  • The first calendar trigger opens the trade with a small initial stake.
  • Every subsequent trigger calls adjust_trade_position and adds the same notional to the open trade.
  • The position grows in fills inside a single Trade row. PnL is reported per-trade.
  • Exits only when the user sets one (typically never, for true DCA — stoploss = -0.99 and no populate_exit_trend).

Backtest reference

WindowBTC/USDC 1d, 2025-11-15 → 2026-05-01 (auto-narrowed to data availability, ~10 weeks)
Trades1 (still open at end, force-closed)
Entry orders inside the trade10 (1 initial + 9 weekly DCA, tagged weekly_dca)
Stake per buy~$36.87
Total invested~$365 of $10,000 wallet
Per-trade PnL+10.0%
Wallet PnL+0.37% / +$36.61
Holding66 days
Backtest ID01kqyz1ysdy9dyw7tbdrhz5gek

The (rejected_signals: 9) warning in logs is normal: populate_entry_trend keeps emitting Monday flags even while a trade is open, but adjust_trade_position does the actual buys.

The Freqtrade primitives that make this work

These four flags are the difference between v1 (1 trade ever, the rest rejected) and v2 (a real ladder of fills). All four are required:

python
position_adjustment_enable = True
max_entry_position_adjustment = 26   # cap on number of weekly adds
max_dca_multiplier = 27.0            # 1 initial + 26 adds

Plus two callbacks:

  • custom_stake_amount — divides the user-configured stake by max_dca_multiplier so the initial entry leaves room for the future weekly adds.
  • adjust_trade_position — the calendar trigger. Returns (stake, tag) to add, None to do nothing.

Reference implementation

python
from freqtrade.strategy import IStrategy
from freqtrade.persistence import Trade
from datetime import datetime
import pandas as pd


class WeeklyDcaBtcStrategy(IStrategy):
    minimal_roi = {"0": 100.0}   # never exit on profit target
    stoploss = -0.99             # never exit on stop
    trailing_stop = False
    timeframe = "1d"
    process_only_new_candles = True
    startup_candle_count = 5
    can_short = False

    # The piece naive translations miss.
    position_adjustment_enable = True
    max_entry_position_adjustment = 26   # ~6 months of weekly buys
    max_dca_multiplier = 27.0            # 1 initial + 26 weekly adds

    def populate_indicators(self, dataframe: pd.DataFrame, metadata: dict) -> pd.DataFrame:
        dataframe["dow"] = pd.to_datetime(dataframe["date"]).dt.dayofweek
        return dataframe

    def populate_entry_trend(self, dataframe: pd.DataFrame, metadata: dict) -> pd.DataFrame:
        # Initial entry on the first Monday encountered.
        dataframe.loc[(dataframe["dow"] == 0) & (dataframe["volume"] > 0), "enter_long"] = 1
        return dataframe

    def populate_exit_trend(self, dataframe: pd.DataFrame, metadata: dict) -> pd.DataFrame:
        return dataframe

    def custom_stake_amount(self, pair: str, current_time: datetime, current_rate: float,
                            proposed_stake: float, min_stake, max_stake: float,
                            leverage: float, entry_tag, side: str, **kwargs) -> float:
        # Reserve room for the future weekly adds.
        return proposed_stake / self.max_dca_multiplier

    def adjust_trade_position(self, trade: Trade, current_time: datetime,
                              current_rate: float, current_profit: float,
                              min_stake, max_stake: float,
                              current_entry_rate: float, current_exit_rate: float,
                              current_entry_profit: float, current_exit_profit: float,
                              **kwargs):
        if trade.has_open_orders:
            return None
        if current_time.weekday() != 0:   # Monday only
            return None
        # Skip the Monday on which the initial entry was placed (Freqtrade
        # calls adjust_trade_position on the same candle as the initial
        # entry; without this guard you double-buy on week 1).
        filled = trade.select_filled_orders(trade.entry_side)
        if filled:
            last_dt = filled[-1].order_filled_utc
            if last_dt and last_dt.date() == current_time.date():
                return None
        # Buy the same notional as the initial entry every Monday.
        first_stake = filled[0].stake_amount_filled if filled else (min_stake or 10)
        return (first_stake, "weekly_dca")

Config requirements

json
{
  "exchange": { "name": "hyperliquid", "pair_whitelist": ["BTC/USDC"] },
  "stake_currency": "USDC",
  "stake_amount": 1000,
  "dry_run_wallet": {"USDC": 10000},
  "timeframe": "1d",
  "max_open_trades": 1,
  "stoploss": -0.99,
  "minimal_roi": { "0": 100.0 },
  "entry_pricing": { "price_side": "same" },
  "exit_pricing": { "price_side": "same" },
  "pairlists": [{ "method": "StaticPairList" }]
}

stake_amount is the post-division budget the user wants per buy times max_dca_multiplier. With stake_amount: 1000 and max_dca_multiplier: 27, each Monday buy is ~$37; total budget is ~$1000.

dry_run_wallet must be ≥ stake_amount (Freqtrade keeps a 1% reserve, so the strict gate is stake_amount ≤ dry_run_wallet × 0.99). Default dry_run_wallet is 1000; bump it up if you raise stake.

Show full SKILL.md (212 more words)Show less

Common pitfalls

  1. No position_adjustment_enable. Without it, repeat Monday flags are silently rejected and you get one trade ever. The classic v1 mistake.
  2. No same-day guard in adjust_trade_position. Without the filled[-1].order_filled_utc.date() == current_time.date() check, the strategy double-buys on the Monday the initial entry was placed.
  3. Forgetting to scale stake_amount. Without custom_stake_amount returning proposed_stake / max_dca_multiplier, the first buy uses the full configured stake and the wallet runs out before week 5.
  4. Using populate_exit_trend to "exit half". Doesn't work — Freqtrade only knows full exits via populate_exit_trend. Partial exits go through adjust_trade_position returning a negative stake.
  5. Setting stoploss ≥ -0.5. A real DCA isn't supposed to stop out on a 50% drawdown. Use -0.99 so the stop never triggers, then exit manually if needed.

Variants

  • Daily / monthly cadence: change current_time.weekday() != 0 to current_time.day != 1 (1st of month) or remove the guard entirely (every candle close).
  • Drawdown-aware DCA: add a check on current_profit < -0.10 to add EXTRA on top of the calendar — buy more when down 10%. Combine the calendar check with current_profit < threshold.
  • Spot vs futures: works on both. Use BTC/USDC for spot (trading_mode: "spot" or omit) or BTC/USDC:USDC for perp (trading_mode: "futures", margin_mode: "cross"). DCA is most idiomatic on spot.

Sources

© Superior-Trade, 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/dca-weekly of Superior-Trade/superior-skills.

Open the folder on GitHubat commit 9d41db5

Compare with similar skills

Dca Weekly 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.

Dca Weekly compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dca Weekly this skillSuperior-Trade/superior-skills214—~2kAutomated safety check: PassMIT
Tushare Datazillionare/zillionare3212 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle875—~5.9kAutomated safety check: PassMIT
Polyclawchainstacklabs/polyclaw3591 repos~2kAutomated safety check: PassApache-2.0
Markdownfacioquo/stock-indicators-dotnet1.2k—~812Automated safety check: PassApache-2.0

Similar skills

  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    321 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    5k GitHub stars~1.3k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    875 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Polyclaw

    chainstacklabs/polyclaw

    Trade on Polymarket via split + CLOB execution. An agent skill from chainstacklabs/polyclaw.

    359 GitHub starsUsed in 1 repo~2k tokens
    Business, Finance & HRAuto-check passed
  • Markdown

    facioquo/stock-indicators-dotnet

    Format and lint Markdown in this repository against GitHub Flavored Markdown and its markdownlint-cli2 configuration — headers, lists, code fences, callouts (VitePress containers on docs-site pages…

    1.2k GitHub stars~812 tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Openmobius Skill

    MobiusQuant/OpenMobius-skill

    Provides multi-school trading Q&A, chart/OHLCV analysis, annotation, and fresh-market workflows covering ICT/SMC, ChanLun, Wyckoff, Price Action, Order Flow, VSA, and Elliott Wave.

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

More from Superior-Trade/superior-skills

All 31 skills in this repo
  • Superior Trade Auth

    Superior-Trade/superior-skills

    A skill your agent uses when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using…

    214 GitHub stars~950 tokensUpdated 29 days ago
    Auto-check passed
  • Deposit Qr

    Superior-Trade/superior-skills

    A skill your agent uses when a user needs a QR code or wallet payment URI to fund a Superior-managed EVM wallet on a specific chain before using Lighter, Polymarket, Hyperliquid, or other Superior…

    214 GitHub stars~1.1k tokensUpdated 29 days ago
    Auto-check passed
  • External Deposit

    Superior-Trade/superior-skills

    A skill your agent uses when a user wants to fund or bridge from an external wallet through a third-party UI such as Relay, especially when asking for MetaMask Mobile QR codes, bridge links…

    214 GitHub stars~1.7k tokensUpdated 29 days ago
    Auto-check passed
  • Aerodrome

    Superior-Trade/superior-skills

    A skill your agent uses when creating, validating, backtesting, deploying, sizing, or troubleshooting Aerodrome/Base spot trading strategies through the Superior Trade API, especially Freqtrade…

    214 GitHub stars~2.3k tokensUpdated 29 days ago
    Auto-check passed
  • Polymarket

    Superior-Trade/superior-skills

    A skill your agent uses when the user wants to trade, research, or backtest Polymarket prediction markets through Superior Trade — finding markets by slug or event URL, placing a single immediate…

    214 GitHub stars~4.2k tokensUpdated 29 days ago
    Auto-check passed
  • Backtesting

    Superior-Trade/superior-skills

    A skill your agent uses when running, interpreting, or designing backtests on Superior Trade — anything about backtest windows, trade-count thresholds, exit-reason mix, parameter sweeps…

    214 GitHub stars~2.9k tokensUpdated 29 days ago
    Auto-check passed

Questions about Dca Weekly

What does Dca Weekly do?

A skill your agent uses when writing, validating, or troubleshooting a recurring scheduled buy strategy (DCA, dollar-cost averaging, weekly buys, daily buys, monthly accumulation, accumulator) on…. Dca Weekly is an agent skill from Superior-Trade/superior-skills. Use when writing, validating, or troubleshooting a recurring scheduled buy strategy (DCA, dollar-cost averaging, weekly buys, daily buys, monthly accumulation, accumulator) on Superior Trade — especially anything that should "buy more of the same pair" on a calendar trigger rather than a price trigger.

When should I use Dca Weekly?

Dca Weekly fits situations like: troubleshooting a recurring scheduled buy strategy (DCA; dollar-cost averaging; monthly accumulation; accumulator) on Superior Trade — especially anything that should buy more of the same pair on a calendar trigger rather than a price trigger.

How do I install Dca Weekly in Claude Code?

Run `npx skills add Superior-Trade/superior-skills --skill dca-weekly -a claude-code`. Or copy the skill folder (skills/dca-weekly in Superior-Trade/superior-skills) into .claude/skills/dca-weekly in your project. Claude Code loads it when a task matches its description.

How do I install Dca Weekly in Codex?

Run `npx skills add Superior-Trade/superior-skills --skill dca-weekly -a codex`. Or copy the skill folder (skills/dca-weekly in Superior-Trade/superior-skills) into .agents/skills/dca-weekly in your project. Codex loads it when a task matches its description.

Can I use Dca Weekly 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 Superior-Trade/superior-skills --skill dca-weekly -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dca-weekly, .gemini/skills/dca-weekly, .github/skills/dca-weekly and .opencode/skills/dca-weekly in your project.

What does Dca Weekly need to run?

SKILL.md names no scripts, command-line tools or credentials: Dca Weekly is instructions for the agent only. Our summary lists: Python 3.

Does Dca Weekly access the network?

SKILL.md names 2 domains. As links in the text: freqtrade.io and github.com. This is read from the text; nothing was executed.

Is Dca Weekly 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 Dca Weekly use?

Dca Weekly is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dca Weekly use?

About 2k tokens (SKILL.md is roughly 8k 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 Dca Weekly?

Skills that share tags, products or a category with Dca Weekly: Tushare Data (zillionare/zillionare, 321 stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 5k stars), Digital Oracle (komako-workshop/digital-oracle, 875 stars) and Polyclaw (chainstacklabs/polyclaw, 359 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dca Weekly?

Superior-Trade (a GitHub organization) maintains it in Superior-Trade/superior-skills, which has 214 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on September 10, 2026.

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