Agent skill

Dca Planner

by nirholas in nirholas/three.ws

Plan a dollar-cost-averaging schedule for a Solana token - total budget, number of buys, interval, per-buy size, slippage and price-impact guards - check it against fees and the user's risk limits…

Apache-2.0Auto-check passed

Install Dca Planner

skills CLI
$ npx skills add nirholas/three.ws --skill dca-planner -a claude-code

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

GitHub CLI
$ gh skill install nirholas/three.ws dca-planner --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/nirholas/three.ws.git skills-src && mkdir -p .claude/skills && cp -r skills-src/community-skills/skills/dca-planner .claude/skills/dca-planner && 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-planner
GitHub stars
228
Token cost
~1k tokens
SKILL.md length
501 words
Files
3 (incl. scripts)
Skills in repo
92
Repo updated
First seen
Licence
Apache-2.0

At a glance

Plan a dollar-cost-averaging schedule for a Solana token - total budget, number of buys, interval, per-buy size, slippage and price-impact guards - check it against fees and the user's risk limits…

  • Works in 4 steps: Token mint address. Run token safety… → Total budget in SOL. Check it against… → Interval: how often to buy. Daily and… → …
  • The user says DCA
  • SKILL.md covers Collect four things, Sanity checks before you show…, Show the plan and Placing it (three.ws agent,…, plus 1 more section
  • Runs JavaScript scripts from its folder; calls node; reaches three.ws

What it does

Dca Planner is an agent skill from nirholas/three.ws. Plan a dollar-cost-averaging schedule for a Solana token - total budget, number of buys, interval, per-buy size, slippage and price-impact guards - check it against fees and the user's risk limits, and produce the exact order for the agent's orders API, previewed before anything is placed. Use when the user says DCA, "buy a little every day", "accumulate over a month", recurring buys, or asks how to spread an entry over time.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `metadata.json`).

It works with Solana. The repository describes itself as: Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web… The licence is Apache-2.0.

When your agent uses it

  • The user says DCA
  • Buy a little every day
  • Accumulate over a month
  • Asks how to spread an entry over time

Example prompts

  • “s risk limits, and produce the exact order for the agent”
  • “buy a little every day”
  • “accumulate over a month”
  • “/dca-planner”

Requirements

  • Node.js

Workflow steps

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

  1. Token mint address. Run token safety diligence first if it has not been done in this conversation; do not schedule 30 buys of a token that…
  2. Total budget in SOL. Check it against the user's risk rules: a DCA is still one position, and its full total counts toward the per-token…
  3. Interval: how often to buy. Daily and weekly are the defaults; hourly only makes sense for budgets large enough that each buy stays…
  4. Duration: how long to keep buying.

What it can do on your machine

Read from SKILL.md and the folder at commit ec8d1d2. 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

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • three.ws

    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 Planner loads about 1k tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 501 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from nirholas/three.ws at commit ec8d1d2, republished under its Apache-2.0 licence (© nirholas). 501 words, ~1,027 tokens.

Download SKILL.mdSave it as .claude/skills/dca-planner/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
dca-planner
description
Plan a dollar-cost-averaging schedule for a Solana token - total budget, number of buys, interval, per-buy size, slippage and price-impact guards - check it against fees and the user's risk limits, and produce the exact order for the agent's orders API, previewed before anything is placed. Use when the user says DCA, "buy a little every day", "accumulate over a month", recurring buys, or asks how to spread an entry over time.

DCA planner

You design a recurring-buy plan the user can read in ten seconds and the platform can execute exactly. You plan and preview. You never place the order without the user's explicit yes to the final numbers.

Collect four things

  1. Token mint address. Run token safety diligence first if it has not been done in this conversation; do not schedule 30 buys of a token that can be frozen.
  2. Total budget in SOL. Check it against the user's risk rules: a DCA is still one position, and its full total counts toward the per-token concentration cap.
  3. Interval: how often to buy. Daily and weekly are the defaults; hourly only makes sense for budgets large enough that each buy stays meaningful.
  4. Duration: how long to keep buying.

slices = duration / interval (at most 1000, the orders API maximum) and per-buy size = total / slices.

Sanity checks before you show a plan

  • Minimum buy size. Under about 0.01 SOL per buy, base fees plus slippage eat a visible share of every purchase. Propose a longer interval instead.
  • Liquidity. Each buy should be under 1% of pool liquidity (GET https://three.ws/api/crypto/token?address=<mint>). Otherwise the plan moves the price against itself.
  • Slippage: 300 bps (3%) is a sane default for liquid tokens; thin pools may need more. Say what you picked and why.
  • Price-impact ceiling: 3% per buy by default. The agent's own trade limits (GET https://three.ws/api/agents/<agent_id>/trade/limits: per_trade_sol, daily_budget_sol, max_price_impact_pct) apply to every fill as well. If per_trade_sol is below the per-buy size, or daily_budget_sol is below a day's buys, the plan will be refused at fire time. Catch that now.
  • End date: set expires_at a day after the last buy so a delayed final slice still runs and the order cannot live forever.

The bundled planner does the arithmetic and the fee check, and prints the order body:

bash
node scripts/dca-plan.mjs --mint <mint> --total-sol 3 --every 1d --for 30d
node scripts/dca-plan.mjs --mint <mint> --total-sol 3 --every 12h --for 2w --slippage-bps 500 --json
Show full SKILL.md (216 more words)Show less

Show the plan

Plan: 30 buys of 0.1 SOL, one a day, 22 Sep to 21 Oct. Total 3 SOL. Guards: 3% slippage, 3% price-impact ceiling per buy. Stops on 23 Oct. Fits your limits: 3 SOL is 7.5% of a 40 SOL portfolio, under the 10% cap.

Then ask: "Place this plan on <agent name>?"

Placing it (three.ws agent, owner only)

  1. Preview. Validates the order and runs the trade firewall without placing anything: POST https://three.ws/api/agents/<agent_id>/orders/preview with the body the planner printed:
    json
    { "type": "dca", "side": "buy", "mint": "<mint>", "size_sol": 0.1,
      "schedule": { "interval_seconds": 86400, "slices": 30 },
      "slippage_bps": 300, "max_price_impact_pct": 3, "expires_at": "<ISO date>" }
  2. Show the preview verdict. Stop if it says block.
  3. Only after the user answers yes to this exact plan: POST https://three.ws/api/agents/<agent_id>/orders with the same body. Report the order id.
  4. To stop early: DELETE https://three.ws/api/agents/<agent_id>/orders/<order_id>, or POST .../orders/cancel-all.

Sells work the same way with "side": "sell" and either size_tokens or sell_pct per slice.

Rules

  • DCA reduces timing risk; it does not make a bad token good. Never present it as safe.
  • Never raise the budget, shorten the interval, or loosen a guard without the user asking.
  • Buying moves real funds on every slice. Placing the order needs a clear yes to the token, total, per-buy size and schedule, shown together.

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

Files

SKILL.md and 2 other files (scripts) in community-skills/skills/dca-planner of nirholas/three.ws.

  • SKILL.md
  • metadata.json
  • scripts/dca-plan.mjs

Open the folder on GitHubat commit ec8d1d2

Compare with similar skills

Dca Planner 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 Planner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dca Planner this skillnirholas/three.ws228—~1kAutomated safety check: PassApache-2.0
Solana Devsolana-foundation/solana-dev-skill574—~3.8kAutomated safety check: PassMIT
Meme Coin Security Auditawarexone/Agentic-Bug-Hunter5.3k1 repos~2.4kAutomated safety check: PassMIT
Swapper Depositswapperfinance/swapper-toolkit852—~1.8kAutomated safety check: PassMIT
PNP Prediction Markets on Solanainternet-court/internet-court-skill6.5k—~7.5kAutomated safety check: NotesMIT
Minara Crypto Trading and WalletMinara-AI/minara-skills362—~5.7kAutomated safety check: PassNone

Similar skills

  • Solana Dev

    solana-foundation/solana-dev-skill

    A skill your agent uses when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "fuzz my…

    574 GitHub stars~3.8k tokensUpdated today
    Backend & APIsAuto-check passed
  • Meme Coin Security Audit

    awarexone/Agentic-Bug-Hunter

    Screens EVM and Solana meme coins for rug pull signs such as hidden mint, honeypot logic and fee tricks, starting with fast kill signals before any code review.

    5.3k GitHub starsUsed in 1 repo~2.4k tokens
    SecurityAuto-check passed
  • Swapper Deposit

    swapperfinance/swapper-toolkit

    Deposit and bridge funds into a wallet or protocol using Swapper Finance.

    852 GitHub stars~1.8k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed
  • PNP Prediction Markets on Solana

    internet-court/internet-court-skill

    Creates, trades and settles permissionless prediction markets on Solana with any SPL token as collateral, including social-media and custom-oracle markets.

    6.5k GitHub stars~7.5k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check: notes
  • Minara Crypto Trading and Wallet

    Minara-AI/minara-skills

    Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.

    362 GitHub stars~5.7k tokensUpdated 22 days ago
    Business, Finance & HRAuto-check passed
  • Manifest

    Bonasa-Tech/manifest

    A skill your agent uses when building, debugging, or integrating with the Manifest DEX on Solana, especially for TypeScript SDK usage, transaction construction with ManifestClient, market state…

    158 GitHub stars~478 tokensUpdated today
    DevelopmentAuto-check passed

More from nirholas/three.ws

All 92 skills in this repo
  • Add Shader Cursor Trail

    nirholas/three.ws

    Add the Shaders WebGPU mouse effect used for the Tidal Commons hero: a white twinkling halftone cursor trail driven by ChromaFlow, masked through a DotGrid, finished with chromatic ripples and film…

    228 GitHub starsUsed in 1 repo~760 tokens
    Auto-check passed
  • Publish Project To GitHub

    nirholas/three.ws

    Package a finished local project into an intentional GitHub repository, create a strong README and visual preview, push it safely, configure a public GitHub Pages URL when the project is compatible…

    228 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check: notes
  • Audit a website or digital experience against its supplied source references for originality and plagiarism risk.

    228 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Turn a completed daily UI inspiration capture into exactly five original landing-page builds, one per separate Codex task, using Sites.

    228 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Write Like Meng On X

    nirholas/three.ws

    Write, rewrite, review, or continuously refine X/Twitter posts in Meng To's current voice using his deduplicated authored-post corpus, personal and product context, shared resources, and Content…

    228 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Browser Video Recording

    nirholas/three.ws

    Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography…

    228 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed

Works with

Questions about Dca Planner

What does Dca Planner do?

Plan a dollar-cost-averaging schedule for a Solana token - total budget, number of buys, interval, per-buy size, slippage and price-impact guards - check it against fees and the user's risk limits…. ws. Plan a dollar-cost-averaging schedule for a Solana token - total budget, number of buys, interval, per-buy size, slippage and price-impact guards - check it against fees and the user's risk limits, and produce the exact order for the agent's orders API, previewed before anything is placed.

When should I use Dca Planner?

Dca Planner fits situations like: the user says DCA; buy a little every day; accumulate over a month; asks how to spread an entry over time.

How do I install Dca Planner in Claude Code?

Run `npx skills add nirholas/three.ws --skill dca-planner -a claude-code`. Or copy the skill folder (community-skills/skills/dca-planner in nirholas/three.ws) into .claude/skills/dca-planner in your project. Claude Code loads it when a task matches its description.

How do I install Dca Planner in Codex?

Run `npx skills add nirholas/three.ws --skill dca-planner -a codex`. Or copy the skill folder (community-skills/skills/dca-planner in nirholas/three.ws) into .agents/skills/dca-planner in your project. Codex loads it when a task matches its description.

Can I use Dca Planner 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 nirholas/three.ws --skill dca-planner -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-planner, .gemini/skills/dca-planner, .github/skills/dca-planner and .opencode/skills/dca-planner in your project.

What does Dca Planner need to run?

Going by SKILL.md and its folder, Dca Planner needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js.

Does Dca Planner access the network?

SKILL.md names 1 domain. In commands or code: three.ws; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Dca Planner 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Dca Planner use?

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

How many tokens does Dca Planner use?

About 1k tokens (SKILL.md is roughly 4.1k 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 Planner?

Skills that share tags, products or a category with Dca Planner: Solana Dev (solana-foundation/solana-dev-skill, 574 stars), Meme Coin Security Audit (awarexone/Agentic-Bug-Hunter, 5.3k stars), Swapper Deposit (swapperfinance/swapper-toolkit, 852 stars) and PNP Prediction Markets on Solana (internet-court/internet-court-skill, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dca Planner?

nirholas (a GitHub user) maintains it in nirholas/three.ws, which has 228 GitHub stars. The repository holds 92 skills in this directory. The repository was last updated on October 9, 2026.

Source: nirholas/three.ws on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.