Agent skill

football

European football matches — upcoming games, results, and highlights for briefings.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/football-timkrase-clawdis-skills

Metadata

Additional technical details for this skill

clawdis 
{
    "env": [
        "FOOTBALL_DATA_API_KEY"
    ],
    "emoji": "\u26bd",
    "requires": {
        "bins": [
            "node",
            "curl"
        ]
    }
}

SKILL.md

Football Skill ⚽

Track European football matches — upcoming games, live scores, and results.

Quick Start

bash
# Upcoming matches (next 7 days)
{baseDir}/scripts/football.js upcoming

# Today's matches
{baseDir}/scripts/football.js today

# Specific league
{baseDir}/scripts/football.js upcoming --league bundesliga
{baseDir}/scripts/football.js upcoming --league premier-league
{baseDir}/scripts/football.js upcoming --league champions-league

# Interesting matches only (top teams, derbies)
{baseDir}/scripts/football.js highlights

# Results from recent matches
{baseDir}/scripts/football.js results

Supported Leagues

League Code API
Bundesliga bundesliga, bl1 OpenLigaDB (free)
2. Bundesliga bundesliga2, bl2 OpenLigaDB (free)
DFB Pokal dfb OpenLigaDB (free)
Premier League premier-league, pl football-data.org
La Liga la-liga, pd football-data.org
Serie A serie-a, sa football-data.org
Ligue 1 ligue-1, fl1 football-data.org
Champions League champions-league, cl football-data.org
Europa League europa-league, el football-data.org

Morning Briefing Integration

For daily briefings, use:

bash
{baseDir}/scripts/football.js briefing

Returns a compact summary of:

  • Today's interesting matches
  • Yesterday's notable results
  • Upcoming highlights this week

API Keys

OpenLigaDB (German leagues): No key required! ✅

football-data.org (other leagues): Free tier available

  1. Register at https://www.football-data.org/client/register
  2. Set FOOTBALL_DATA_API_KEY environment variable

"Interesting" Match Criteria

The highlights command filters for:

  • Top teams playing (Bayern, Dortmund, Real, Barça, etc.)
  • Derby matches
  • Champions League knockout games
  • Title deciders (late season, close standings)

Output Formats

bash
# JSON (default)
{baseDir}/scripts/football.js today

# Human-readable
{baseDir}/scripts/football.js today --human

# Compact (for briefings)
{baseDir}/scripts/football.js briefing --compact

Didn't find tool you were looking for?

Be as detailed as possible for better results