nutmeg-research SKILL.md skillA

nutmeg-research from withqwerty/nutmeg is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add withqwerty/nutmeg/nutmeg-research@git:20261010.da11349

Pins git:20261010.da11349 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
withqwerty/nutmeg
Path
skills/research/SKILL.md
Versions recorded
5
Latest version
git:20261010.da11349, committed Oct 10, 2026
First version recorded
Oct 8, 2026
Size
14,009 bytes
Repository stars
55
License
none declared

Run football analysis as a research project that shows its work: a question, a plan with reasons, a claim ledger tying every number to evidence. Use for work to publish or decide on (shortlists, match or opposition reports, memos, charts, threads) or when sourced numbers are asked for.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Research

Work like a research assistant, not an autopilot. The user must be able to check every input, every
query and every number, and see why each choice was made. A research project keeps that trail in
files the user and their teammates can open.

Read and follow `${CLAUDE_PLUGIN_ROOT}/docs/accuracy-guardrail.md`. Provider facts come from
football-docs and IDs from the Reep Register, never from memory.

## The nutmeg command

Run every project command through the plugin's core, in exactly this form:

```bash
python3 "${CLAUDE_PLUGIN_ROOT}/core/nutmeg.py" <command> ...
```

Below, `nutmeg <command>` is short for that line. Run `nutmeg --help` or `nutmeg <command> --help`
for the options. If `python3` is missing or older than 3.10, tell the user that research projects
need Python 3.10 or newer, and continue the task without a project.

## When to start a project

Start one when the user wants analysis to publish or to decide on: a shortlist, a match or
opposition report, a memo, a chart or thread for social media, or any answer they ask to be
sourced. Do not start one for a quick question ("what is PPDA?", "what is Opta's qualifier for a
cross?"), a code fix or a lookup.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add withqwerty/nutmeg/nutmeg-research@sha256:f51eec5bea04c26b

The line at the top of this page pins the label git:20261010.da11349, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ivmjmkp3bept5mio.svg)](https://markdownregistry.com/a/art_ivmjmkp3bept5mio)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 8, 2026 and Oct 10, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261010.da11349 latest2026-10-10 da11349 14,009 BA view · diff
git:20261010.c81d5db2026-10-10 c81d5db 15,936 BA view · diff
git:20261010.307dc252026-10-10 307dc25 15,665 BA view · diff
git:20261009.a7751512026-10-09 a775151 13,206 BA view · diff
git:20261008.9a530e22026-10-08 9a530e2 11,889 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14009 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

withqwerty/nutmeg · 55 stars · license none declared · pushed 2026-10-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ivmjmkp3bept5mio
GET https://markdownregistry.com/api/v1/resolve?ref=withqwerty/nutmeg/nutmeg-research
GET https://markdownregistry.com/api/v1/blob/f51eec5bea04c26b0f781b0d38d0be3389a68c5d98df60907fa5bb5f4632fdbb

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from withqwerty/nutmeg

CLAUDE.md CLAUDE.md file
withqwerty/nutmeg · CLAUDE.md
git:20261011.b131b98 · audit A · 55 stars
nutmeg-acquire SKILL.md skill
withqwerty/nutmeg · skills/acquire/SKILL.md · Get football data: fetch, scrape or download from StatsBomb, Opta, FBref, Understat, SportMonks, Wyscout, Kaggle or any…
git:20261013.4ef97fb · audit A · 55 stars
nutmeg-analyse SKILL.md skill
withqwerty/nutmeg · skills/analyse/SKILL.md · Explore and interpret football data, and judge players or teams from stats: rankings, 'who is the best', 'is he a poor…
git:20261010.3c7d5af · audit A · 55 stars
nutmeg-brainstorm SKILL.md skill
withqwerty/nutmeg · skills/brainstorm/SKILL.md · Ideas for football data visualisations: chart types and designs for match reports, player profiles, dashboards and…
git:20261010.da11349 · audit A · 55 stars
nutmeg-compute SKILL.md skill
withqwerty/nutmeg · skills/compute/SKILL.md · Calculate derived football metrics and models. Use when the user wants to compute xG, xGOT, PPDA, passing networks…
git:20261008.9a530e2 · audit A · 55 stars
nutmeg-heal SKILL.md skill
withqwerty/nutmeg · skills/heal/SKILL.md · Fix broken football data scrapers and pipelines: failed requests, API errors, changed formats. Also drafts upstream…
git:20261010.da11349 · audit A · 55 stars
nutmeg-learn SKILL.md skill
withqwerty/nutmeg · skills/learn/SKILL.md · Explain football analytics concepts and provider documentation: what a metric means (xG, PPDA, xT), learning paths and…
git:20261010.da11349 · audit A · 55 stars
nutmeg SKILL.md skill
withqwerty/nutmeg · skills/nutmeg/SKILL.md · Football data analytics entry point. Use for any task with football data: xG, match or player stats, scouting, shot…
git:20261013.f45c247 · audit A · 55 stars
nutmeg-review SKILL.md skill
withqwerty/nutmeg · skills/review/SKILL.md · Review football data code and visualisations for correctness. Use after building a chart, data pipeline, or analysis…
git:20261008.9a530e2 · audit A · 55 stars
nutmeg-store SKILL.md skill
withqwerty/nutmeg · skills/store/SKILL.md · Store and publish football data: databases, file formats, cloud storage, project layout, and sharing outputs…
git:20261010.da11349 · audit A · 55 stars
nutmeg-wrangle SKILL.md skill
withqwerty/nutmeg · skills/wrangle/SKILL.md · Clean, filter, reshape, join and convert football data, including missing values and large datasets. Use for any data…
git:20261013.8f51874 · audit A · 55 stars

Every file in withqwerty/nutmeg

Browse by kind, by grade A, or by owner.