Agent skill

Fxmacrodata Calendar

by tradermonty in tradermonty/claude-trading-skills

Fetch official FXMacroData macro release-calendar events for trade planning, macro regime checks, and event-risk filters.

MITAuto-check passed

Install Fxmacrodata Calendar

skills CLI
$ npx skills add tradermonty/claude-trading-skills --skill fxmacrodata-calendar -a claude-code

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

GitHub CLI
$ gh skill install tradermonty/claude-trading-skills fxmacrodata-calendar --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/tradermonty/claude-trading-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/fxmacrodata-calendar .claude/skills/fxmacrodata-calendar && 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
fxmacrodata-calendar
GitHub stars
3k
Token cost
~482 tokens
SKILL.md length
206 words
Files
4 (incl. scripts)
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Fetch official FXMacroData macro release-calendar events for trade planning, macro regime checks, and event-risk filters.

  • Works in 3 steps: Run the calendar script → Review events[] for top-tier releases. → Fold the event timing into the trade plan
  • SKILL.md covers Workflow and Authentication
  • Runs Python scripts from its folder; calls python3; reaches api.fxmacrodata.com; needs FXMACRODATA_API_KEY

What it does

Fxmacrodata Calendar is an agent skill from tradermonty/claude-trading-skills. Fetch official FXMacroData macro release-calendar events for trade planning, macro regime checks, and event-risk filters. Use before CPI, NFP, GDP, PCE, retail sales, PMI, and central-bank decision windows.

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `scripts/fetch_calendar.py` and `scripts/tests/test_fetch_calendar.py`).

The repository describes itself as: Claude Code skills for equity investors and traders — market analysis, technical charting, economic calendars, screeners, and trading strategy development. The licence is MIT.

Example prompts

  • “/fxmacrodata-calendar”

Requirements

  • Python 3
  • A credential in FXMACRODATA_API_KEY

Workflow steps

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

  1. Run the calendar script
  2. Review events[] for top-tier releases.
  3. Fold the event timing into the trade plan

What it can do on your machine

Read from SKILL.md and the folder at commit eab8d5c. 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 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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:

    • api.fxmacrodata.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FXMACRODATA_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fxmacrodata Calendar loads about 482 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 206 words of instructions outside code blocks.

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

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 tradermonty/claude-trading-skills at commit eab8d5c, republished under its MIT licence (© tradermonty). 206 words, ~482 tokens.

Download SKILL.mdSave it as .claude/skills/fxmacrodata-calendar/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
fxmacrodata-calendar
description
Fetch official FXMacroData macro release-calendar events for trade planning, macro regime checks, and event-risk filters. Use before CPI, NFP, GDP, PCE, retail sales, PMI, and central-bank decision windows.

FXMacroData Calendar

Retrieve official-source macro release-calendar events from FXMacroData. Use this skill when a trade plan needs event timing, confirmed release dates, or a top-tier macro risk check.

Workflow

  1. Run the calendar script:

    bash
    python3 skills/fxmacrodata-calendar/scripts/fetch_calendar.py --currency usd --min-tier 1
  2. Review events[] for top-tier releases.

    Treat a nonzero exit as an unverified event-risk state, never as an empty calendar. Only a successful response containing events: [] establishes that no matching events were returned. The client accepts results only when the response currency matches the request and data_quality confirms an official, current, non-proxy, non-fallback, timestamp-complete, point-in-time-safe source. Each event must include an announcement timestamp and a non-empty release identifier.

  3. Fold the event timing into the trade plan:

    • pause new entries around high-impact releases;
    • reduce leverage or position size;
    • schedule follow-up review after the actual value is available;
    • explain which event and timestamp drove the adjustment.

Authentication

Set FXMACRODATA_API_KEY for authenticated FXMacroData endpoints. Public USD calendar rows can be fetched without a key. The client uses the canonical https://api.fxmacrodata.com/v1 endpoint and accepts --min-tier values 1, 2, or 3 only. Live calendar responses currently include market_tier; the skill treats it as an extension field and requires integer values 1 through 3 for filtering, although the current CalendarReleaseRow OpenAPI schema does not declare that field.

© tradermonty, 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) in skills/fxmacrodata-calendar of tradermonty/claude-trading-skills.

  • SKILL.md
  • requirements.txt
  • scripts/fetch_calendar.py
  • scripts/tests/test_fetch_calendar.py

Open the folder on GitHubat commit eab8d5c

Compare with similar skills

Fxmacrodata Calendar 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.

Fxmacrodata Calendar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fxmacrodata Calendar this skilltradermonty/claude-trading-skills3k—~482Automated safety check: PassMIT
Fxmacrodatasickn33/agentic-awesome-skills47k1 repos~2.9kAutomated safety check: PassMIT
Eventscoreyhaines31/marketingskills54k—~3kAutomated safety check: PassMIT
Google Calendarcodewhale-hq/Codewhale41k—~512Automated safety check: PassMIT
Event-Driven Sentiment SignalsHKUDS/Vibe-Trading35k—~2.1kAutomated safety check: PassMIT
Calendar Event Creatorjeremylongshore/tons-of-skills-marketplace2.8k—~584Automated safety check: PassMIT

Similar skills

  • Fxmacrodata

    sickn33/agentic-awesome-skills

    Query FXMacroData for official-source macro indicators, release calendars, central-bank policy rates, FX rates and CFTC positioning across 22 currencies.

    47k GitHub starsUsed in 1 repo~2.9k tokens
    Marketing & SEOAuto-check passed
  • Events

    coreyhaines31/marketingskills

    When the user wants to plan, run, sponsor, speak at, or get pipeline from events — webinars, conferences, trade shows, meetups, dinners, workshops, virtual summits, or user conferences.

    54k GitHub stars~3k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Google Calendar

    codewhale-hq/Codewhale

    Reads schedules, checks free and busy time, and creates or updates Google Calendar events through the Calendar API, with care around invites and recurring series.

    41k GitHub stars~512 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Scores news, announcements and macro events with the LLM, stores them in an event CSV and blends the decaying event signal with technical signals in signal_engine.py.

    35k GitHub stars~2.1k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Calendar Event Creator

    jeremylongshore/tons-of-skills-marketplace

    Create calendar event creator operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~584 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Agent skill for trading-predictor - invoke with $agent-trading-predictor

    74k GitHub starsUsed in 2 repos~2.5k tokens
    Business, Finance & HRAuto-check passed

More from tradermonty/claude-trading-skills

All 74 skills in this repo
  • Technical Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.

    3k GitHub starsUsed in 4 repos~4.6k tokens
    Auto-check passed
  • Theme Detector

    tradermonty/claude-trading-skills

    Detect and analyze trending market themes across sectors. An agent skill from tradermonty/claude-trading-skills.

    3k GitHub starsUsed in 2 repos~4.9k tokens
    Auto-check passed
  • Trader Memory Core

    tradermonty/claude-trading-skills

    Track investment theses across their lifecycle — from screening idea to closed position with postmortem.

    3k GitHub starsUsed in 2 repos~4.3k tokens
    Auto-check passed
  • Edge Strategy Reviewer

    tradermonty/claude-trading-skills

    Critically review strategy drafts from edge-strategy-designer for edge plausibility, overfitting risk, sample size adequacy, and execution realism.

    3k GitHub starsUsed in 1 repo~988 tokens
    Auto-check passed
  • Sector Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing sector rotation patterns and market cycle positioning.

    3k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Stanley Druckenmiller Investment

    tradermonty/claude-trading-skills

    Druckenmiller Strategy Synthesizer - Integrates 8 upstream skill outputs (Market Breadth, Uptrend Analysis, Market Top, Macro Regime, FTD Detector, VCP Screener, Theme Detector, CANSLIM Screener)…

    3k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed

Questions about Fxmacrodata Calendar

What does Fxmacrodata Calendar do?

Fetch official FXMacroData macro release-calendar events for trade planning, macro regime checks, and event-risk filters. Fxmacrodata Calendar is an agent skill from tradermonty/claude-trading-skills. Fetch official FXMacroData macro release-calendar events for trade planning, macro regime checks, and event-risk filters.

How do I install Fxmacrodata Calendar in Claude Code?

Run `npx skills add tradermonty/claude-trading-skills --skill fxmacrodata-calendar -a claude-code`. Or copy the skill folder (skills/fxmacrodata-calendar in tradermonty/claude-trading-skills) into .claude/skills/fxmacrodata-calendar in your project. Claude Code loads it when a task matches its description.

How do I install Fxmacrodata Calendar in Codex?

Run `npx skills add tradermonty/claude-trading-skills --skill fxmacrodata-calendar -a codex`. Or copy the skill folder (skills/fxmacrodata-calendar in tradermonty/claude-trading-skills) into .agents/skills/fxmacrodata-calendar in your project. Codex loads it when a task matches its description.

Can I use Fxmacrodata Calendar 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 tradermonty/claude-trading-skills --skill fxmacrodata-calendar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fxmacrodata-calendar, .gemini/skills/fxmacrodata-calendar, .github/skills/fxmacrodata-calendar and .opencode/skills/fxmacrodata-calendar in your project.

What does Fxmacrodata Calendar need to run?

Going by SKILL.md and its folder, Fxmacrodata Calendar needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named FXMACRODATA_API_KEY. Our summary lists: Python 3; A credential in FXMACRODATA_API_KEY.

Does Fxmacrodata Calendar access the network?

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

Is Fxmacrodata Calendar 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 Fxmacrodata Calendar use?

Fxmacrodata Calendar 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 Fxmacrodata Calendar use?

About 482 tokens (SKILL.md is roughly 1.9k 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 Fxmacrodata Calendar?

Skills that share tags, products or a category with Fxmacrodata Calendar: Fxmacrodata (sickn33/agentic-awesome-skills, 47k stars), Events (coreyhaines31/marketingskills, 54k stars), Google Calendar (codewhale-hq/Codewhale, 41k stars) and Event-Driven Sentiment Signals (HKUDS/Vibe-Trading, 35k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fxmacrodata Calendar?

tradermonty (a GitHub user) maintains it in tradermonty/claude-trading-skills, which has 2,977 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on October 9, 2026.

Source: tradermonty/claude-trading-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.