{"slug": "show-hn-algo-trading-skills-trading-failure-modes-ai-agents-don-t-know", "title": "Show HN: Algo-Trading-Skills – trading failure modes AI agents don't know", "summary": "A community project called Algo-Trading-Skills has released 501 structured algorithmic trading skills across 16 engineering domains, each backed by working reference implementations and 20,291 unit tests, under the Apache 2.0 license. The library follows the agentskills.io standard and works with Claude Code, GitHub Copilot, Codex CLI, Cursor, and Gemini CLI, mapping skills to frameworks including SEC Rule 15c3-5, Reg NMS, Reg SHO, FINRA, EU MiFID II/RTS 6/MAR, UK FCA, ASIC, SEBI, and ISDA OTC standards. The project is independent and not affiliated with Anthropic PBC, and its authors state it provides engineering guidance rather than financial, legal, or compliance advice.", "body_md": "**501 algorithmic trading skills · 16 engineering domains · 5 regulatory & exchange frameworks · 501 working reference implementations backed by 20,291 unit tests · agentskills.io standard · Works with Claude Code, GitHub Copilot, Codex CLI, Cursor, Gemini CLI and any tool that reads `SKILL.md` · Apache 2.0**\n\n[Get Started](#quick-start) · [What's Inside](#whats-inside--16-categories) · [How It's Verified](#what-verified-means-here) · [Frameworks & Standards](#five-regulatory--exchange-frameworks-one-skill-library) · [Platforms](#compatible-platforms--zero-config-auto-discovery) · [Contributing](#contributing)\n\n**Community Project** — This is an independent, community-created project. Not affiliated with Anthropic PBC or any broker, exchange, or vendor referenced in this repository.\n\n⚠️ 📈 **Engineering Guidance, Not Financial, Legal, or Compliance Advice** — Authorized & lawful use only. These skills encode production engineering practices for trading infrastructure. They do not constitute financial, legal, tax, or regulatory compliance advice, do not guarantee strategy profitability, and do not eliminate the risk of capital loss in live trading. Only deploy against paper accounts or live environments where risk limits are strictly enforced. Consult qualified legal, tax, and compliance professionals in your jurisdiction before deploying live trading systems. See [SECURITY.md](/HimanshuJ16/Algo-Trading-Skills/blob/main/SECURITY.md) and [CODE_OF_CONDUCT.md](/HimanshuJ16/Algo-Trading-Skills/blob/main/CODE_OF_CONDUCT.md).\n\nAn AI coding agent can write a WebSocket client, a backtest loop, or an order-placement function that looks completely correct — right library calls, clean structure, plausible logic — and still fail catastrophically in production for reasons that have nothing to do with code syntax: a broker invalidates a token overnight in a way its docs don't mention, a backtest silently uses a bar's own close to predict its own direction, a risk limit lives inside the same function it's supposed to constrain, or a WebSocket callback blocks the read loop during exactly the volatility spike a strategy exists to catch.\n\n**Your AI agent doesn't know these failure modes — unless you give it these skills.**\n\nThis repo contains **501 structured skills** spanning **16 engineering domains**, each following the [agentskills.io](https://agentskills.io) open standard. The library maps across key financial regulatory & exchange frameworks — SEC Rule 15c3-5, Reg NMS / Reg SHO, FINRA, EU MiFID II / RTS 6 / MAR, UK FCA, ASIC, SEBI, and ISDA OTC derivative standards. Clone it, point your agent at it, and your next trading system deployment gets expert-level quant infrastructure guidance in seconds.\n\nEvery skill also states **where it stops**. A `## When NOT to Use` section on all 501 skills names the cases the skill does not cover and hands each one to the skill that does — because an agent applying a correct playbook to the wrong problem is its own failure mode, and it is the one a keyword match is most likely to cause.\n\nEach skill maps to the industry standards, exchange protocols, and regulatory mandates that fit its subject:\n\n| Framework / Standard | Scope | What It Maps | Key Mapped Skills | \n|---|---|---|---|\n| **US SEC / FINRA** | SEC Rule 15c3-5, Reg NMS Rule 611, Reg SHO, PDT Rule 4210, Form 1099-B | Pre-trade risk controls, order protection, short sale locates, pattern day trading, tax lot reconciliation | `us-reg-nms-order-protection-rule-compliance` ,`us-reg-sho-short-sale-locate-requirements` ,`sec-rule-15c3-5-risk-controls-us` ,`wash-sale-rule-tracking-us` | \n| **EU MiFID II / RTS 6 / MAR** | MiFID II Article 48, RTS 6 organizational requirements, MAR market abuse surveillance | System resilience, kill switches, OTR limits, wash trade & spoofing self-detection, double volume caps | `mifid-ii-algo-trading-compliance-eu` ,`wash-trade-and-spoofing-self-detection` ,`eu-market-abuse-regulation-mar-surveillance` | \n| **UK FCA & Senior Managers Regime** | FCA SYSC 25, MIFIDPRU, Senior Managers & Certification Regime (SM&CR) | Algorithmic trading system controls, algorithmic accountability, key person governance | `uk-fca-algorithmic-trading-systems-controls` ,`uk-senior-managers-regime-algo-accountability` | \n| **Global Regulatory (ASIC, SEBI, MAS, IIROC)** | ASIC MIR, SEBI Algo Circulars, MAS Cyber Hygiene, IIROC Electronic Trading | Regional exchange order tagging, circuit breakers, risk-gate dependencies, kill switches | `asic-market-integrity-rules-automated-trading` ,`india-sebi-algo-trading-tagging-requirements` ,`mas-singapore-algo-trading-guidelines` | \n| **ISDA & OTC Derivatives** | ISDA Master Agreement, SPAN Margin, Options Greeks, Variance Swaps | Collateral management, cross-margining, delta hedging, synthetic TRS exposure, volatility derivatives | `options-margin-span-calculation-global` ,`total-return-swap-synthetic-exposure` ,`variance-swap-and-volatility-derivative-pricing` | \n\n### Example — Each skill maps directly to regulatory mandates, broker APIs, and institutional standards:\n\n| Skill | Primary Regulatory / Exchange Standard | Broker / Platform Touchpoints | Operational Safety Target | \n|---|---|---|---|\n| [`order-placement-idempotency`](/HimanshuJ16/Algo-Trading-Skills/blob/main/skills/order-placement-idempotency) | SEC Rule 15c3-5 / MiFID II RTS 6 | Fyers, Zerodha, Breeze, Upstox, Alpaca, IBKR | Zero duplicate executions on reconnection | \n| [`kill-switch-and-drawdown-circuit-breakers`](/HimanshuJ16/Algo-Trading-Skills/blob/main/skills/kill-switch-and-drawdown-circuit-breakers) | SEC Rule 15c3-5 (Pre-Trade Controls) | Universal / Broker-Agnostic | Instant capital protection on drawdown breach | \n| [`wash-trade-and-spoofing-self-detection`](/HimanshuJ16/Algo-Trading-Skills/blob/main/skills/wash-trade-and-spoofing-self-detection) | EU MAR / FINRA Rule 5210 | Exchange Order Feeds | Pre-trade self-cross prevention & cancellation audit | \n| [`us-reg-sho-short-sale-locate-requirements`](/HimanshuJ16/Algo-Trading-Skills/blob/main/skills/us-reg-sho-short-sale-locate-requirements) | US SEC Reg SHO Rule 203(b)(1) | US Equity Brokers / Prime Brokers | Mandatory pre-short locate verification & buy-in tracking | \n| [`withdrawal-velocity-limits-and-anomaly-detection`](/HimanshuJ16/Algo-Trading-Skills/blob/main/skills/withdrawal-velocity-limits-and-anomaly-detection) | MAS Cyber Hygiene / Custody Risk | Coinbase, Fireblocks, BitGo, HSM | Automated hot wallet freeze on velocity breach | \n\n```\n# Option 1: Claude Code — install one domain, not the whole library\n/plugin marketplace add HimanshuJ16/Algo-Trading-Skills\n/plugin install algo-trading-risk-management\n/plugin install algo-trading-broker-integration\n\n# Option 2: skills CLI — pick the skills you want interactively\nnpx skills add HimanshuJ16/Algo-Trading-Skills\n\n# Option 3: git clone, then run the gates yourself\ngit clone https://github.com/HimanshuJ16/Algo-Trading-Skills.git\ncd Algo-Trading-Skills\npip install -r requirements-dev.txt\n\npython tools/validate_skills.py    # structure, frontmatter, cross-references & packaging\npython tools/run_all_tests.py      # every skill's unit test suite, isolated per subprocess\n```\n\n**Install one domain, not all of them.** Claude Code loads the name and description of\nevery skill in an installed plugin into the model's context at the start of every\nsession. The marketplace therefore ships **one plugin per engineering domain**\n(`algo-trading-risk-management`, `algo-trading-execution-algorithms`, …), each a few\nthousand tokens. An `algo-trading-skills-all` plugin exists for completeness, but it\ncosts tens of thousands of tokens per session — reach for it only if you know you want\nthat. One caveat on disk rather than context: every plugin entry points at the repository\nroot, so installing a single domain checks out the whole tree (about 100 MB); only that\ndomain's skills are loaded into the session.\n\nRun one skill's suite on its own — the same command every skill quotes in its own Verification section:\n\n```\npython -m unittest discover -s skills/order-placement-idempotency/scripts\n```\n\nWorks immediately with Claude Code, GitHub Copilot, OpenAI Codex CLI, Cursor, Gemini CLI, and any agentskills.io-compatible platform.\n\nThe quantitative trading and financial software engineering domain requires deep practitioner knowledge across market microstructure, exchange protocols, and risk engineering. AI agents can help build and scale trading infrastructure — but only if they have structured practitioner playbooks to work from. Today's generic LLMs can write Python code and API wrappers, but they lack the operational context that separates code which works in a notebook from code that survives a live market.\n\nExisting trading libraries give you broker SDKs, indicator formulas, or naive strategy backtests. None of them give an AI agent the structured decision-making workflow a senior quant infrastructure engineer follows: when to use each technique, when *not* to, what prerequisites to check, how to execute step-by-step, and how to verify results in production. That is the gap this project fills.\n\n**Algo-Trading-Skills** is not a collection of toy scripts. It is an AI-native knowledge base built from the ground up for the [agentskills.io](https://agentskills.io) standard — YAML frontmatter for sub-second discovery, structured Markdown for step-by-step execution, and reference files for deep technical context. Every skill encodes real practitioner workflows, not generic LLM summaries.\n\nSkill libraries are easy to generate and hard to trust. Everything in this table is re-checked by CI on every push and pull request, on Python 3.10, 3.12 and 3.13, so the claims stay true or the build goes red.\n\n| **501 working reference implementations** | ~292,000 lines of Python under `skills/*/scripts/` . Not pseudocode — importable modules that validate their inputs and raise on bad data; about half define their own exception classes, the rest raise the builtins. 466 of the 501 import nothing outside the Python standard library; the 35 that do reach mostly for numpy or pandas, so the whole suite still runs on`requirements-dev.txt` alone. | \n| **501 unit test suites · 20,291 tests** | ~228,000 lines of tests. Each suite runs in its own subprocess with a timeout, so no skill can leak module state into another or hang the build. A skill whose own reference implementation fails its own tests fails the build. | \n| **A machine-enforced contract** | [`tools/validate_skills.py`](/HimanshuJ16/Algo-Trading-Skills/blob/main/tools/validate_skills.py) checks the frontmatter contract, the seven required body sections,`scripts/` layout, every skill cross-reference in both skills and repo docs, that every documented test command runs from the repository root, and that the plugin manifests cover every skill exactly once. | \n| **The specification, not our reading of it** | CI also runs [`skills-ref`](https://github.com/agentskills/agentskills/tree/main/skills-ref) , the official agentskills.io reference validator, against every skill. It needs Python 3.11+, so that job runs on the newer interpreters while the library itself stays 3.10-compatible. | \n| **Descriptions that say when to trigger** | Every description starts with \"Use when …\" and fits in 280 characters — enforced, because it is the only thing an agent reads before choosing a skill, and it costs context on every session. | \n| **Generated files can't drift** | `index.json` and the plugin marketplace are generated and carry no timestamp;`--check` modes fail CI if either is stale. | \n| **Verification you can paste** | Every skill quotes a runnable command in its `## Verification` section, alongside the concrete assertions to check by hand. | \n| **Sourced, or explicitly unsourced** | 458 of 501 `references/standards.md` cite at least one primary source — the rule text, the exchange notice, the vendor spec. Where no external standard exists, the file says so and labels its numbers as configurable defaults rather than inventing an authority for them. | \n| **Stated scope boundaries** | `## When NOT to Use` on every skill, naming the excluded cases and handing each to the skill that owns it. | \n| **Examples that use the real code** | The three walkthroughs in `examples/` import the actual skill helpers rather than re-implementing them, and CI runs all three. | \n\nThe CI workflow is [`.github/workflows/validate-skills.yml`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.github/workflows/validate-skills.yml).\n\nThe library covers 16 core engineering domains spanning domestic and global markets — crypto exchanges, forex brokers, multi-currency and multi-timezone data handling, regulatory compliance, multi-asset derivatives, execution algorithms, custody/security, cross-strategy portfolio management, market microstructure, alternative-data research, and tax/accounting.\n\n| Domain | Skills | Key capabilities | \n|---|---|---|\n| [`broker-integration`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **36** | Headless auth (REST + Selenium), token lifecycle via live probing, order idempotency, per-broker rate limiting, borrow cost modeling, cost budgeting | \n| [`real-time-architecture`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **31** | Producer-consumer tick pipelines, burst-safe buffering, explicit backpressure policy, WebSocket subscription reconciliation after a reconnect | \n| [`backtesting-methodology`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **31** | Lookahead bias elimination, walk-forward validation, realistic slippage/fee/latency simulation, synthetic data generation, standardized tearsheets | \n| [`financial-ml`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **38** | Leakage-free feature engineering, offline-train/online-infer deployment, triple barrier labeler, sample weighting, model staleness detection | \n| [`risk-management`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **39** | Kill switches and drawdown circuit breakers, correlation-aware exposure limits, Kupiec test VaR backtesting, tail risk hedging, risk escalation matrices | \n| [`deployment-ops`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **30** | systemd process supervision, paper-to-live promotion checklist, IaC for trading hosts, canary releases, chaos engineering, secrets vault | \n| [`global-market-integration`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **44** | Crypto exchange APIs (Binance/Coinbase/Kraken/Deribit/Bybit/OKX), FX (OANDA/MT5), CME Globex, Eurex, HKEX, SGX, ASX, JPX, CBOE, LSE, Xetra | \n| [`regulatory-compliance-global`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **38** | US SEC Rule 15c3-5, PDT, FINRA, EU MiFID II/RTS 6/MAR, UK FCA, ASIC, MAS, India SEBI, Canada IIROC, Hong Kong SFC, Japan FSA | \n| [`multi-asset-derivatives`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **28** | SPAN margin calculation, futures contract roll automation, real-time Greeks aggregation, perpetual futures funding rates, variance swaps, CDS, quanto options | \n| [`execution-algorithms`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **32** | TWAP/VWAP order slicing, POV execution, implementation shortfall minimization, iceberg detection, smart order routing (SOR), dark pool routing, auctions | \n| [`data-management-global`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **37** | Global exchange holiday calendars, DST transition handling, multi-timezone session scheduling, multi-currency P&L, ISIN/CUSIP/SEDOL cross-referencing | \n| [`crypto-custody-security`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **29** | Wallet key custody, hot-cold split, withdrawal whitelisting, multi-sig approval, HSM integration, Shamir secret sharing, MPC custody | \n| [`portfolio-multi-strategy`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **28** | Cross-strategy correlation monitoring, performance-based capital reallocation, strategy retirement criteria, risk parity allocation, meta-strategy signal arbitration | \n| [`market-microstructure-latency`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **24** | Colocation latency budgets, PTP clock sync, tick-to-trade measurement, order book signals, adverse selection measurement, FPGA/microwave evaluation | \n| [`quant-research-alt-data`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **20** | Satellite imagery signals, credit card transaction data, web-scraped sentiment, supply chain networks, Google Trends, social media bot filtering, transcript NLP | \n| [`tax-accounting-reporting-global`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md) | **16** | US wash sale tracking, FIFO vs specific-lot accounting, Section 475 MTM election, crypto tax lot tracking, 1099-B reconciliation, Section 1256 futures tax | \n\nFull searchable index: [`index.json`](/HimanshuJ16/Algo-Trading-Skills/blob/main/index.json). Every skill listed by domain with its trigger description: [`docs/ROADMAP_500.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/ROADMAP_500.md).\n\nThe full library is roughly **3.5 million tokens** of Markdown — far past any context window. Progressive disclosure is what makes it usable: an agent searches short descriptions to find the right skill, then loads only that one.\n\n| Stage | What the agent reads | Cost | \n|---|---|---|\n| **Discover** | `index.json` — name, description, domain and tags for every skill, queryable without touching a single skill file | ~250 tokens per skill as shipped (~80 for a name+description projection) | \n| **Load** | The one matching `SKILL.md` — workflow, scope boundaries, pitfalls, verification | ~2,000-3,700 tokens (median ~2,700) | \n| **Go deeper** | `references/` and`scripts/` for that skill only, once it is actually implementing | on demand | \n\n`index.json` is a single JSON object with a `skills` array and a `subdomains` count map, so an agent can filter by domain or grep descriptions and narrow the whole library to a handful of candidates before loading anything.\n\nUser prompt: *\"My Fyers bot's live orders keep getting placed twice after a timeout\"*\n\nAgent's internal process:\n\n```\n  1. Queries index.json descriptions for all 501 skills\n     → identifies order-placement-idempotency and token-lifecycle-live-probing as top matches.\n\n  2. Loads top match: skills/order-placement-idempotency/SKILL.md\n     → checks When NOT to Use first — this is order placement, not a cancel-request race,\n       so the skill applies.\n     → follows the structured Workflow section: classify timeout as ambiguous (not failed),\n       reconcile against broker order book before any retry.\n\n  3. Loads references/workflows.md for full sequence diagrams and\n     scripts/order_ledger.py for working helper logic.\n\n  4. Validates results using the Verification section\n     → runs `python -m unittest discover -s skills/order-placement-idempotency/scripts`\n     → confirms a simulated network timeout no longer produces duplicate executions.\n```\n\nWithout these skills, the agent guesses at retry logic and doubles order risk. With them, it follows the exact playbook a senior trading engineer would use.\n\nEvery skill follows a consistent directory structure:\n\n```\nskills/order-placement-idempotency/\n├── SKILL.md                  ← Skill definition (YAML frontmatter + Markdown body)\n├── references/\n│   ├── standards.md          ← Broker/framework coverage + regulatory touchpoints\n│   └── workflows.md          ← Deep technical procedure reference\n├── scripts/\n│   ├── order_ledger.py       ← Working reference implementation\n│   └── test_order_ledger.py  ← Its unittest suite\n└── assets/\n    └── checklist.md          ← Printable sign-off checklist\n```\n\nEach helper is a **standalone module** — no imports from other skills, no shared package — so you can lift one file out of the repo and into your own codebase without dragging the library along.\n\n```\n---\nname: order-placement-idempotency\ndescription: >-\n  Use whenever a bot places, modifies, or cancels live orders and must guarantee it\n  never double-executes an order due to retries, timeouts, or reconnects\nlicense: Apache-2.0\nmetadata:\n  domain: algorithmic-trading\n  subdomain: broker-integration\n  tags: broker-integration, idempotency, client-order-id, order-ledger, retry-safety\n  brokers_frameworks: Fyers API v3; Zerodha Kite Connect; Upstox API v2; IBKR API\n  version: \"2.0.0\"\n  author: algo-trading-skills-contributors\n---\n```\n\nThe [agentskills.io specification](https://agentskills.io/specification) allows six\ntop-level fields, so everything this repository adds lives under `metadata:` as string\nvalues. Two rules on `description` do the heavy lifting for discovery: it starts with\n**\"Use when …\"** (the situation an agent is in, not a description of the subject), and\nit fits in **280 characters**, because every installed skill's description is loaded\ninto context on every session. Both are enforced by\n[`tools/validate_skills.py`](/HimanshuJ16/Algo-Trading-Skills/blob/main/tools/validate_skills.py), alongside the official `agentskills validate`.\n\n```\n## When to Use          Trigger conditions — when should an AI agent activate this skill?\n## When NOT to Use      Scope boundaries — each excluded case handed to the skill that owns it.\n## Prerequisites        Required tools, access, and environment setup.\n## Workflow             Step-by-step execution guide with specific decision points.\n## Common Pitfalls      Named, specific failure modes this skill prevents.\n## Verification         How to confirm the skill was executed successfully, with a runnable command.\n## Related Skills       Cross-links to other skills in this repo.\n```\n\nAll seven sections are required. [`tools/validate_skills.py`](/HimanshuJ16/Algo-Trading-Skills/blob/main/tools/validate_skills.py) enforces them in CI, along with the `scripts/` layout and the runnability of every documented test command — see [`docs/skill-anatomy.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/skill-anatomy.md) for the contract in prose and [`.github/workflows/validate-skills.yml`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.github/workflows/validate-skills.yml) for the pipeline.\n\nThis repository includes native auto-discovery instructions for all major AI coding platforms:\n\n| Platform / Agent | Zero-Config Rule File | Auto-Discovery Standard | \n|---|---|---|\n| **Claude Code** | [`CLAUDE.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/CLAUDE.md) +[`.claude-plugin/`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.claude-plugin) | Anthropic Claude Code project + plugin marketplace convention | \n| **OpenAI Codex CLI / OpenHands** | [`AGENTS.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/AGENTS.md) | Open cross-tool agent instruction format | \n| **Gemini CLI** | [`GEMINI.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/GEMINI.md) | Google Gemini CLI project instructions | \n| **GitHub Copilot** | [`.github/copilot-instructions.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.github/copilot-instructions.md) | GitHub Copilot repo-level rules | \n| **Cursor** | [`.cursor/rules/algo-trading-skills.mdc`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.cursor/rules/algo-trading-skills.mdc) | Cursor MDC rule format | \n| **Cline / Roo Code** | [`.clinerules`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.clinerules) | Cline / Roo Code system rule | \n| **Windsurf** | [`.windsurfrules`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.windsurfrules) | Windsurf rule configuration | \n| **Continue** | [`.continue/rules/algo-trading-skills.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.continue/rules/algo-trading-skills.md) | Continue dev auto-discovery rule | \n| **Aider** | [`CONVENTIONS.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/CONVENTIONS.md) /[`.aider.conf.yml`](/HimanshuJ16/Algo-Trading-Skills/blob/main/.aider.conf.yml) | Aider project conventions | \n\nThe table above lists the tools this repository ships a rule file for. Beyond those,\nthe skills are plain `SKILL.md` directories in the [agentskills.io](https://agentskills.io)\nformat, so any agent or framework that reads that format can load them — point it at\n`skills/` and it has everything it needs.\n\nTo see how skills chain together in complete pipelines, explore the runnable walkthroughs in [`examples/`](/HimanshuJ16/Algo-Trading-Skills/blob/main/examples):\n\n- [`examples/01_resilient_order_execution_and_circuit_breaker.py`](/HimanshuJ16/Algo-Trading-Skills/blob/main/examples/01_resilient_order_execution_and_circuit_breaker.py) — Order idempotency + drawdown circuit breakers + live token probing.\n- [`examples/02_lookahead_free_backtest_with_slippage.py`](/HimanshuJ16/Algo-Trading-Skills/blob/main/examples/02_lookahead_free_backtest_with_slippage.py) — Point-in-time signal engine + market impact slippage simulation + performance tear-sheet.\n- [`examples/03_cross_strategy_risk_parity_allocation.py`](/HimanshuJ16/Algo-Trading-Skills/blob/main/examples/03_cross_strategy_risk_parity_allocation.py) — Rolling strategy correlations + risk parity rebalancing + automated strategy retirement.\n\nCross-cutting maps live in [`mappings/broker-api-coverage.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/mappings/broker-api-coverage.md) and [`mappings/regulatory-coverage.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/mappings/regulatory-coverage.md); the system architecture the skills were extracted from is in [`docs/architecture.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/docs/architecture.md).\n\nThis repository supports machine-discoverable documentation standards for LLMs and AI crawlers:\n\n- [`llms.txt`](/HimanshuJ16/Algo-Trading-Skills/blob/main/llms.txt) — Concise index of core documentation, skill categories, and developer entrypoints.\n- [`llms-full.txt`](/HimanshuJ16/Algo-Trading-Skills/blob/main/llms-full.txt) — Full architecture breakdown and domain mapping for large context windows.\n\n| Version | Highlights | \n|---|---|\n| **v3.0.0** | Frontmatter migrated to the agentskills.io specification (repo fields under `metadata:` ), one Claude Code plugin per domain instead of one monolith, descriptions rewritten as \"Use when …\" triggers capped at 280 characters, duplicate skills merged, and CI extended with`skills-ref` , a Python version matrix, generated-file drift checks and the cookbook examples. See[CHANGELOG.md](/HimanshuJ16/Algo-Trading-Skills/blob/main/CHANGELOG.md) . | \n| **v2.0.0** | Reference implementations upgraded across the core broker, risk and real-time skills. | \n| **v1.0.0** | Initial library across 16 engineering domains, with `tools/validate_skills.py` and`tools/run_all_tests.py` enforced in CI. | \n\nThis project grows through community contributions. Here is how to get involved:\n\n- **Add a new skill** — Follow the template and frontmatter structure enforced by`tools/validate_skills.py` and submit a PR.\n- **Improve existing skills** — Update workflows, refine code engines, add unit tests, or extend regulatory mappings.\n- **Report issues** — Found an edge case or missing failure mode? Open an issue.\n\nBefore opening a PR, run the gates locally. CI runs these plus the agentskills.io\nreference validator and the cookbook examples — see\n[`CONTRIBUTING.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/CONTRIBUTING.md#how-the-library-is-verified) for the full pipeline:\n\n```\npython tools/validate_skills.py\npython tools/run_all_tests.py\npython tools/build_index.py --check      # regenerate and commit if this fails\npython tools/build_marketplace.py --check\npython -m unittest discover -s tests\n```\n\nThe quality bar is in [`CONTRIBUTING.md`](/HimanshuJ16/Algo-Trading-Skills/blob/main/CONTRIBUTING.md), and it is a high one: would following this skill have prevented a real production bug, and is its Verification section actually checkable? A regulatory or broker-behaviour claim must be verifiable against an authoritative source — **a missing claim is better than a wrong or fabricated one.**\n\nEvery PR is reviewed for technical accuracy and `agentskills.io` standard compliance.\n\nIf you use this project in research or publications:\n\n```\n@software{algo_trading_skills,\n  author       = {Jangir, Himanshu},\n  title        = {Algo-Trading-Skills},\n  year         = {2026},\n  url          = {https://github.com/HimanshuJ16/Algo-Trading-Skills},\n  license      = {Apache-2.0},\n  note         = {501 structured algorithmic trading skills for AI agents,\n                  mapped to SEC Rule 15c3-5, Reg NMS, MiFID II, FCA, SEBI, and ISDA standards}\n}\n```\n\nThis project is licensed under the [Apache License 2.0](/HimanshuJ16/Algo-Trading-Skills/blob/main/LICENSE). You are free to use, modify, and distribute these skills in both personal and commercial projects.\n\nIf this project helps your quantitative trading work, consider giving it a ⭐\n\n⭐ **Star** · 🍴 **Fork** · 💬 **Discuss** · 📝 **Contribute**\n\n*Community project by [@HimanshuJ16](https://github.com/HimanshuJ16). Not affiliated with Anthropic PBC or any broker referenced in this repository.*", "url": "https://wpnews.pro/news/show-hn-algo-trading-skills-trading-failure-modes-ai-agents-don-t-know", "canonical_source": "https://github.com/HimanshuJ16/Algo-Trading-Skills", "published_at": "2026-09-11 02:37:28+00:00", "updated_at": "2026-09-11 02:57:01.896572+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["Algo-Trading-Skills", "agentskills.io", "Claude Code", "GitHub Copilot", "Codex CLI", "Cursor", "Gemini CLI", "Anthropic PBC"], "alternates": {"html": "https://wpnews.pro/news/show-hn-algo-trading-skills-trading-failure-modes-ai-agents-don-t-know", "markdown": "https://wpnews.pro/news/show-hn-algo-trading-skills-trading-failure-modes-ai-agents-don-t-know.md", "text": "https://wpnews.pro/news/show-hn-algo-trading-skills-trading-failure-modes-ai-agents-don-t-know.txt", "jsonld": "https://wpnews.pro/news/show-hn-algo-trading-skills-trading-failure-modes-ai-agents-don-t-know.jsonld"}}