A Agent Skill for working with [MQL5 Algo Forge](https://forge.mql5.io).

Instead of hardcoding a fixed list of endpoints, this skill teaches at your ai to download the instance's own OpenAPI spec, search it locally, and query it so it stays correct even as the API evolves.

Main Features

• Downloads and caches the instance's swagger.v1.json spec (once per session, refreshed hourly)
• Searches the spec by keyword instead of guessing or memorizing endpoint paths
• Tests whether a given endpoint is public or requires a token, rather than assuming
• Handles token setup safely (env var or .env), with guidance for bash/zsh, PowerShell, and CMD
• Works the same on Linux, macOS, and Windows all the request/caching logic is plain Python

Repository Structure

AlgoForgeSkill/
├── SKILL.md                        # instructions for yor ai reads to use this skill
└── scripts/
    ├── swagger_client.py           # download/cache/search the API spec used as-is
    └── api_request_example.py      # template for making a request adapt per endpoint

Installation

Claude.ai (Example)

Upload this folder (or a zip of it) as a custom skill. See Anthropic's skills documentation for the current upload flow.

---

Quick Start

Once installed, just mention Algo Forge, forge.mql5.io, or a Forgejo/Gitea task in your prompt Ai will pick up the skill automatically. For example:

"List the recent Actions runs for the example-org/example-repo repo on Algo Forge"

"Search Algo Forge for public repos related to 'grid trading'"

If a task needs an authenticated endpoint, Claude will ask you to set a FORGEJO_TOKEN environment variable (or a local .env file) it will never ask you to paste the token directly into the chat, and it won't write the token value into any file or response.

---

License

Read Full License By downloading or using this repository, you accept the license terms.

---

Contact

• Platform: MQL5 Community
• Profile: https://www.mql5.com/es/users/nique_372
• Articles: https://www.mql5.com/es/users/nique_372/publications