skill

canoa-skills

Skills for Hermes and Agent Skills ecosystem — CANOA (canoanumis.org)

canoa-dev/canoa-skillscommunitylistedunreviewed

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/canoa-dev/canoa-skills itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 22, 2026

CANOA Skills

Open skills for working with CANOA — Corpus Apertum Nummorum Orbis Antiqui (https://canoanumis.org), an open corpus of ancient world coinage: Greece, Rome, Persia, Carthage, Byzantium and more.

The corpus aggregates ~128,500 coin types, 540,000+ museum specimens, 9,833 hoards, 17,074 dies and 2,600+ mints from the numismatics.org ecosystem and museum collections. Everything is exposed through a free, key-less JSON API — see the skills for how to use it.

Skill	What it does
`skills/canoa-api/`	How to use the CANOA API for numismatics, history, education — endpoints, filters, recipes for kids, hobbyists and researchers, citation and licensing rules
`skills/canoa-hoard-analysis/`	Analyze coin hoards of a region: distribution by emperors and periods, charts (matplotlib), PDF article (headless Chromium)

Installation

With Hermes Agent (or any Agent Skills client), install from the public catalog:

hermes skills search canoa-api
hermes skills install skills-sh/canoa-dev/canoa-skills/skills/canoa-api

Or directly from this repository:

hermes skills install canoa-dev/canoa-skills/skills/canoa-api

The skill needs no API key and no setup — just read it and follow the examples (curl, python3).

Quick tour

# Coins of Nero struck in Rome:
curl "https://canoanumis.org/api/coins?authority=http://nomisma.org/id/nero&mint=36&per_page=100"

# Coins of Rome 54–68 AD:
curl "https://canoanumis.org/api/coins?date_from=54&date_to=68&mint=36"

# Coin card:
curl "https://canoanumis.org/api/coins/ric-i-second-edition-nero-63/"

# Mints as GeoJSON:
curl "https://canoanumis.org/api/mints.geojson?has_coins=1"

Full endpoint reference and recipes are inside skills/canoa-api/SKILL.md.

Data and licensing

Coin type data — Open Database License (ODbL) 1.0, source: numismatics.org projects (OCRE, CRRO, PELLA, …)
Specimen images — © the holding museums; many collections allow non-commercial use only with attribution
Per-collection licenses: https://canoanumis.org/LICENSES.md
This skill itself — CC BY 4.0 (see LICENSE)

When publishing results, credit: Data: CANOA (canoanumis.org), ODbL; image: © <museum>.

Source projects and data

CANOA aggregates data from the numismatics.org ecosystem and museum collections.

Our forks

canoa-dev/nomisma-symbol-svg — fork of nomisma/symbol-svg, SVG images for symbols (primarily monograms) related to coinage
canoa-dev/nomisma_raw — fork of nomisma/data, Nomisma ID text fragments for the wiki

Upstream nomisma.org projects (GitHub)

nomisma/symbol-svg — SVG images for coinage symbols and monograms
nomisma/data — Nomisma ID text fragments
nomisma/site — nomisma.org website (Jekyll)
nomisma/framework — nomisma.org framework
nomisma/scripts — data migration and maintenance scripts

Numismatics.org data projects (sources of the corpus)

OCRE — Online Coins of the Roman Empire
CRRO — Coinage of the Roman Republic Online
PELLA — coinage of Macedon
SCO — Seleucid Coins Online, PCO — Ptolemaic Coins Online, BIGR, AGCO, AOD, LCO, COI, CM — Renaissance Medals Online, OSCAR
Nomisma.org — controlled vocabulary for numismatic concepts

RDF data dumps are published at numismatics.org/rdf/. Museum specimen images come from the holding collections (British Museum, BnF, CN, Fitzwilliam, Dumbarton Oaks, and others — see LICENSES.md).

Contributing

Skills are plain folders with a SKILL.md (Agent Skills format). To add a skill:

Create skills/<name>/SKILL.md with name: and description: frontmatter
Test it: hermes chat --toolsets skills -q "Use the <name> skill to ..."
Open a pull request

New skills about ancient numismatics, history, museum data and education are welcome. Before publishing, run hermes skills publish — the built-in safety scan must pass.