Agent skill

Quant Tidy

by Sixian-Li in Sixian-Li/plain-backtest

Audit and reorganize the Quant multi-project workspace. An agent skill from Sixian-Li/plain-backtest.

MITAuto-check passedBusiness, Finance & HR

Install Quant Tidy

skills CLI
$ npx skills add Sixian-Li/plain-backtest --skill quant-tidy -a claude-code

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

GitHub CLI
$ gh skill install Sixian-Li/plain-backtest quant-tidy --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/Sixian-Li/plain-backtest.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/quant-tidy .claude/skills/quant-tidy && 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
quant-tidy
GitHub stars
190
Token cost
~1.3k tokens
SKILL.md length
636 words
Files
4 (incl. scripts, references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Audit and reorganize the Quant multi-project workspace. An agent skill from Sixian-Li/plain-backtest.

  • Works in 12 steps: Locate the workspace root by finding… → Read references/workspace-contract.md.… → Read backtest/docs/architecture.md and… → …
  • Cleaning Quant files
  • SKILL.md covers Distributed project, Workflow, Guardrails and Resources
  • Runs Python scripts from its folder; calls python

What it does

Quant Tidy is an agent skill from Sixian-Li/plain-backtest. Audit and reorganize the Quant multi-project workspace. Use when moving, renaming, deduplicating, or cleaning Quant files; adding or moving a project; repairing catalog.md, log.md, lineage, path, or environment drift; or checking structural integrity. Routine backtest creation and publication belong to quant-backtest.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/workspace-contract.md` and `scripts/audit_quant_workspace.py`).

It sits in Business, Finance & HR, covering Trading and backtesting. The repository describes itself as: Say It Simply, Test It Properly. Agent-powered strategy research with independent ledger checks and reproducible reports. The licence is MIT.

When your agent uses it

  • Cleaning Quant files
  • Moving a project
  • Repairing catalog.md
  • Environment drift

Example prompts

  • “/quant-tidy”

Requirements

  • Python 3

Workflow steps

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

  1. Locate the workspace root by finding catalog.md, log.md, data/, and backtest/. Read catalog.md and log.md first.
  2. Read references/workspace-contract.md. Preserve shared data and project boundaries defined there.
  3. Read backtest/docs/architecture.md and backtest/experiments/lineage.json, then run backtest/.venv/bin/python -m scripts.audit_workspace…
  4. Inspect the proposed changes before moving files. Never modify purchased raw data. Keep unrelated user changes.
  5. Put shared datasets under data/; put every backtest-only environment, dependency, source, test, document, and experiment under backtest/.
  6. Keep canonical experiments below backtest/experiments//____/, with a matching full created_on in lineage. Keep tests below tests/core…
  7. Keep root catalog.md to one fenced text tree plus its title. Give every important entry a one-sentence purpose; put no status, result…
  8. Append one concise dated item to root log.md for each material outcome. Keep each item near 100 Chinese characters or shorter when one…
  9. When structural work touches experiments, confirm every experiment remains registered in both backtest/experiments/index.md and…
  10. Run .venv/bin/python -m scripts.build_research_catalog after structural experiment/run changes, then run it again with --check. Never…
  11. Re-run the workspace audit and the relevant project tests. Report unresolved failures; do not silently weaken checks.
  12. Keep every linked Agent worktree below the primary repository's visible worktrees/ pool. Use backtest/scripts/manage_worktree.py; treat…

What it can do on your machine

Read from SKILL.md and the folder at commit 36adf23. 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/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

    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

Quant Tidy loads about 1.3k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 636 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.6k

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 Sixian-Li/plain-backtest at commit 36adf23, republished under its MIT licence (© Sixian-Li). 636 words, ~1,324 tokens.

Download SKILL.mdSave it as .claude/skills/quant-tidy/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
quant-tidy
description
Audit and reorganize the Quant multi-project workspace. Use when moving, renaming, deduplicating, or cleaning Quant files; adding or moving a project; repairing catalog.md, log.md, lineage, path, or environment drift; or checking structural integrity. Routine backtest creation and publication belong to quant-backtest.

Quant Tidy

Keep the workspace understandable to a fresh agent without turning the root into a documentation dump.

Distributed project

This skill is versioned at .agents/skills/quant-tidy/ in this repository. Locate the root from the current checkout; do not depend on a user-level skill or the author’s original workspace. Read README.md and backtest/docs/release/scope.md first. The distribution contains canonical data and experiment definitions, not the complete source archives or historical runs.

This directory is an independent distribution, not a linked worktree. Its own data and environment may be real directories. The shared-link requirement below applies only to linked worktrees created from this repository. Root README.md, LICENSE, and THIRD_PARTY_NOTICES.md are intended distribution files.

Workflow

  1. Locate the workspace root by finding catalog.md, log.md, data/, and backtest/. Read catalog.md and log.md first.
  2. Read references/workspace-contract.md. Preserve shared data and project boundaries defined there.
  3. Read backtest/docs/architecture.md and backtest/experiments/lineage.json, then run backtest/.venv/bin/python -m scripts.audit_workspace from backtest/. If unavailable, run scripts/audit_quant_workspace.py --workspace <root> from this skill.
  4. Inspect the proposed changes before moving files. Never modify purchased raw data. Keep unrelated user changes.
  5. Put shared datasets under data/; put every backtest-only environment, dependency, source, test, document, and experiment under backtest/.
  6. Keep canonical experiments below backtest/experiments/<PROGRAM>/<DISPLAY_CODE>__<YY-MM-DD>__<slug>/, with a matching full created_on in lineage. Keep tests below tests/core, data, lifecycle, reporting, or strategies/{der,rot,tim}. After changes, update all hard-coded paths, imports, Markdown links, manifests, hashes, and reproducibility commands. Search for old paths with rg.
  7. Keep root catalog.md to one fenced text tree plus its title. Give every important entry a one-sentence purpose; put no status, result, decision, or plan there.
  8. Append one concise dated item to root log.md for each material outcome. Keep each item near 100 Chinese characters or shorter when one sentence suffices.
  9. When structural work touches experiments, confirm every experiment remains registered in both backtest/experiments/index.md and lineage.json, with exactly one program, one unique display version, and complete parent edges. Confirm active_run_id and latest_validated_run_id point to real lifecycle runs; treat unreferenced running or completed_unvalidated directories as unfinished cleanup, not as new research nodes.
  10. Run .venv/bin/python -m scripts.build_research_catalog after structural experiment/run changes, then run it again with --check. Never hand-edit generated strategy_evolution.md, program_evolution/*.md, scorecard.csv, or research_map.html.
  11. Re-run the workspace audit and the relevant project tests. Report unresolved failures; do not silently weaken checks.
  12. Keep every linked Agent worktree below the primary repository's visible worktrees/ pool. Use backtest/scripts/manage_worktree.py; treat the primary tree as the only canonical delivery location. Before removing a legacy or stale worktree, prove that its branch and validated artifacts are preserved in the primary tree. Shared data and environments must be symlinks, never copies.
Show full SKILL.md (200 more words)Show less

Guardrails

  • Do not initialize Git, connect brokers, or delete raw data unless the user explicitly requests it.
  • Do not put research conclusions in catalog.md.
  • Do not create one explanatory Markdown file per experiment by default; use the central experiment registry and machine config.
  • Do not claim the workspace is tidy while old root paths, stale links, or unregistered experiments remain.
  • Do not move generated run output back to the experiment root or edit a validated run. Preserve pre-lifecycle outputs under an explicitly labeled legacy directory.
  • Do not call a network or agent-session interruption a strategy failure. Resume the active run when possible; prune an interrupted run only after a validated successor exists and the user has authorized cleanup.
  • Do not leave canonical experiments flat. Physical program/version/date classification and lineage.json must agree. Move an experiment with its entire runs/ subtree, update live references, and never rewrite the contents of a validated run.
  • Do not place linked Quant worktrees in hidden, temporary, or external directories, and never overwrite or tolerate an existing real data/environment directory while bootstrapping shared links.

Resources

  • Read references/workspace-contract.md for the directory contract and record formats.
  • Run scripts/audit_quant_workspace.py when the workspace copy of the audit is missing or suspect.

© Sixian-Li, MIT. 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 3 other files (scripts, references) in .agents/skills/quant-tidy of Sixian-Li/plain-backtest.

  • SKILL.md
  • agents/openai.yaml
  • references/workspace-contract.md
  • scripts/audit_quant_workspace.py

Open the folder on GitHubat commit 36adf23

Compare with similar skills

Quant Tidy 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.

Quant Tidy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Quant Tidy this skillSixian-Li/plain-backtest190—~1.3kAutomated 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 yesterday
    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 Sixian-Li/plain-backtest

  • Data Update

    Sixian-Li/plain-backtest

    Operate and assess the Quant workspace market-data layer through the tested data-update CLI.

    190 GitHub stars~1.6k tokensUpdated 12 days ago
    Auto-check passed
  • Quant Backtest

    Sixian-Li/plain-backtest

    Run the standardized Quant backtest pipeline from a natural-language strategy through data gating, tested implementation, PyBroker execution, independent-ledger reconciliation, parameter robustness…

    190 GitHub stars~2.7k tokensUpdated 12 days ago
    Auto-check passed

Questions about Quant Tidy

What does Quant Tidy do?

Audit and reorganize the Quant multi-project workspace. An agent skill from Sixian-Li/plain-backtest. Quant Tidy is an agent skill from Sixian-Li/plain-backtest. Audit and reorganize the Quant multi-project workspace.

When should I use Quant Tidy?

Quant Tidy fits situations like: cleaning Quant files; moving a project; repairing catalog.md; environment drift.

How do I install Quant Tidy in Claude Code?

Run `npx skills add Sixian-Li/plain-backtest --skill quant-tidy -a claude-code`. Or copy the skill folder (.agents/skills/quant-tidy in Sixian-Li/plain-backtest) into .claude/skills/quant-tidy in your project. Claude Code loads it when a task matches its description.

How do I install Quant Tidy in Codex?

Run `npx skills add Sixian-Li/plain-backtest --skill quant-tidy -a codex`. Or copy the skill folder (.agents/skills/quant-tidy in Sixian-Li/plain-backtest) into .agents/skills/quant-tidy in your project. Codex loads it when a task matches its description.

Can I use Quant Tidy 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 Sixian-Li/plain-backtest --skill quant-tidy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/quant-tidy, .gemini/skills/quant-tidy, .github/skills/quant-tidy and .opencode/skills/quant-tidy in your project.

What does Quant Tidy need to run?

Going by SKILL.md and its folder, Quant Tidy needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Quant Tidy access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Quant Tidy 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 Quant Tidy use?

Quant Tidy 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 Quant Tidy use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Quant Tidy?

Skills that share tags, products or a category with Quant Tidy: 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 Quant Tidy?

Sixian-Li (a GitHub user) maintains it in Sixian-Li/plain-backtest, which has 190 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 27, 2026.

Source: Sixian-Li/plain-backtest on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.