nutmeg

A Claude Code plugin that makes Claude an expert at football data analytics.

Who it's for: Anyone who works with football data — analysts, developers, journalists, researchers, hobbyists. If you've ever spent an hour figuring out which Opta qualifier is xG, or why your StatsBomb coordinates are upside down, or how to normalise a heatmap properly, this is for you.

What it does: Gives Claude deep, verified knowledge of football data providers, libraries, and conventions. Claude looks up the actual docs instead of guessing from training data, writes code adapted to your stack, and catches football-specific mistakes in your work.

Why not just ask Claude directly? Claude knows football data exists but its knowledge is frozen and often wrong on specifics — qualifier IDs, API endpoints, coordinate systems, method signatures. These change. nutmeg connects Claude to a live, searchable index of real provider documentation so it gets the details right.

Capabilities

nutmeg gives Claude deep knowledge of football data so it can help you:

• Acquire data from Opta, StatsBomb, Wyscout, SportMonks, FBref, Understat, and more
• Wrangle event streams, transform coordinates, join datasets, handle large files
• Route entity-resolution work to the right public surface: provider facts in football-docs, public ID lookup in Reep Register, reusable matching guidance in reep-toolkit
• Compute derived metrics like xG, PPDA, passing networks, expected threat
• Store data in the right format and publish results via Streamlit, Observable, or static sites
• Analyse matches, players, and teams with statistical rigour
• Learn football analytics concepts, from xG basics to academic research

It adapts to your experience level, preferred programming language, and available data sources.

Install

Full install (Claude Code plugin)

Includes skills, agents, and the football docs MCP server.

# From Claude Code — add the marketplace first (one-time), then install
/plugin marketplace add withqwerty/plugins
/plugin install nutmeg@withqwerty

Skills only (any AI coding agent)

Works with Claude Code, Cursor, Codex, Windsurf, and 40+ other agents via the Agent Skills standard.

npx skills add withqwerty/nutmeg

Nutmeg looks up provider facts in the football-docs MCP server, which this install does not include. Add it to your agent as well (Node.js 22.13 or newer):

claude mcp add football-docs -- npx -y football-docs@0.17.4

For other agents, add the same command (npx -y football-docs@0.17.4) as an MCP server in their settings. Without it, nutmeg says it cannot check provider facts, and labels anything it answers from memory as unverified.

This installs the 11 skills but not the agents or MCP docs server. For the full experience (searchable provider docs, pipeline builder agent, data reviewer agent), use the plugin install above.

Setup

Run /nutmeg and describe what you want to do. On first run, it creates your profile (experience, tools, data access) so all skills adapt accordingly.

Skills

Most users only need two commands — /nutmeg routes everything else automatically.

Entry points