ZhijuCen
a59fc6918a
- Add _to_wine_path(): converts Unix paths under Wine prefix to Windows-style (e.g. ~/.wine/drive_c/... → C:\...) - Set subprocess cwd to Editor's directory (editor.parent) instead of dest.parent — MetaEditor is a Windows EXE and its CWD matters - Use _to_wine_path() for /compile:"..." argument so paths use correct drive-letter format under Wine - Apply both fixes to cmd_compile() and cmd_check()
mql5-skills
MQL5 Agent Skill for MetaTrader 5 development. Conforms to the AgentSkills.io Specification.
What's Inside
An AI agent skill (skills/mql5/SKILL.md) that gives an LLM agent working
knowledge of MQL5 development — positions, orders, indicators, risk management,
backtesting — backed by the full MQL5 programming book and API reference
extracted to Markdown.
skills/mql5/
├── SKILL.md # The agent skill (agentskills.io spec)
├── scripts/
│ ├── verify_sl_tp_formulas.py # Python SL/TP risk formula verification
│ └── ...
└── references/
├── book/ # MQL5 Programming Book (581 pages)
├── docs/ # MQL5 API Reference (4135 pages)
└── symbol-spec/ # Broker symbol specifications (CSV)
Quick Start
Use the Skill
Point your AI agent at skills/mql5/SKILL.md. The skill covers:
- Trading operations: CTrade class, OrderSend, position management
- Indicators: built-in handles, multi-timeframe, custom indicators
- Risk management: PointValue-based SL/TP calculation, lot sizing, currency conversion for cross-pair profit currencies
- Backtesting: Strategy Tester, OnTester custom criteria, optimization
- Pitfalls: 16 documented pitfalls including SL/TP-specific issues
Extract References (Development)
The references/book/ and references/docs/ directories are generated from
mql5.com sitemaps via a two-phase pipeline:
# Phase 1: Download HTML (needs network)
uv run scripts/extract.py download --all
# Phase 2: Convert to Markdown (offline)
uv run scripts/extract.py convert --all
See docs-dev/extraction.md for the full pipeline design.
Verify Risk Formulas
python skills/mql5/scripts/verify_sl_tp_formulas.py
Tests SL/TP calculation against real symbol specs (XAUUSD, USDJPY) with verified PointValue-based formulas.
Symbol Specs
Broker-specific symbol specifications live in skills/mql5/references/symbol-spec/:
| File | Symbol | Calc Mode | Contract Size | Digits |
|---|---|---|---|---|
specs-XAUUSD.csv |
XAUUSD | CFD Leverage | 100 | 2 |
specs-USDJPY.csv |
USDJPY | Forex | 100,000 | 3 |
These are used by the verification script and can be extended for additional symbols.
Project Structure
mql5-skills/
├── AGENTS.md # Project conventions for AI agents
├── LICENSE # MIT
├── README.md # This file
├── pyproject.toml # uv project config (Python 3.14)
├── sitemaps/ # Source sitemaps from mql5.com
│ ├── sitemap_book_en.xml # 581 URLs → programming book
│ └── sitemap_docs_en.xml # 4135 URLs → API reference docs
├── scripts/ # Extraction pipeline
│ └── extract.py # XML → HTML → Markdown
├── skills/mql5/ # The MQL5 agent skill
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── docs-dev/ # Development documentation
│ ├── extraction.md # Extraction pipeline design
│ ├── naming.md # File/folder naming conventions
│ ├── skill-design.md # SKILL.md content plan
│ └── symbol-spec.md # Symbol spec workflow
└── html_cache/ # Downloaded HTML (gitignored)
Development
# Setup
uv sync
# Run extraction
uv run scripts/extract.py download --all
uv run scripts/extract.py convert --all
# Verify formulas
python skills/mql5/scripts/verify_sl_tp_formulas.py
License
MIT