Agent skill

Sports News

by machina-sports in machina-sports/sports-skills

Sports news via RSS/Atom feeds and Google News. An agent skill from machina-sports/sports-skills.

MITAuto-check passedMarketing & SEO

Install Sports News

skills CLI
$ npx skills add machina-sports/sports-skills --skill sports-news -a claude-code

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

GitHub CLI
$ gh skill install machina-sports/sports-skills sports-news --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/machina-sports/sports-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sports-news .claude/skills/sports-news && 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
sports-news
GitHub stars
243
Token cost
~1.3k tokens
SKILL.md length
473 words
Files
4 (incl. scripts, references)
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Sports news via RSS/Atom feeds and Google News. An agent skill from machina-sports/sports-skills.

  • Works in 2 steps: fetch_items --google_news --query=""… → Present headlines with source and date.
  • : user asks for recent news
  • SKILL.md covers Quick Start, CRITICAL: Before Any Query, Choosing Dates and Commands, plus 4 more sections
  • Runs Shell scripts from its folder; reaches feeds.bbci.co.uk

What it does

Sports News is an agent skill from machina-sports/sports-skills. Sports news via RSS/Atom feeds and Google News. Fetch headlines, search by query, filter by date. Covers football news, transfer rumors, match reports, and any sport via Google News. Use when: user asks for recent news, headlines, transfer rumors, or articles about any sport. Good for "what's the latest on [team/player]" questions. Supports any Google News query and curated RSS feeds (BBC Sport, ESPN, The Athletic, Sky Sports). Don't use when: user asks for structured data like standings, scores, statistics, or…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/api-reference.md`, `references/rss-feeds.md` and `scripts/validate_params.sh`).

It sits in Marketing & SEO, covering Schema markup and Statistics. It works with Kalshi and Polymarket. The repository describes itself as: Open-source agent skills for live sports data and prediction markets. Football, F1, Kalshi, Polymarket. Zero API keys. SKILL.md format. The licence is MIT.

When your agent uses it

  • : user asks for recent news
  • Transfer rumors
  • Articles about any sport
  • : user asks for structured data like standings

Example prompts

  • “s the latest on [team/player]”
  • “Use the sports-news skill to sport news via RSS/Atom feeds and Google News. An agent skill from machina-sports/sports-skills”
  • “/sports-news”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

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

  1. fetch_items --google_news --query="" --limit=5 --sort_by_date=True
  2. Present headlines with source and date.

What it can do on your machine

Read from SKILL.md and the folder at commit 09eb7e8. 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 1 file in scripts/ (Shell), which the agent can run.

    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:

    • feeds.bbci.co.uk

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Sports News loads about 1.3k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 234 tokens; SKILL.md has 473 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~234
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

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 machina-sports/sports-skills at commit 09eb7e8, republished under its MIT licence (© machina-sports). 473 words, ~1,293 tokens.

Download SKILL.mdSave it as .claude/skills/sports-news/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
sports-news
description
Sports news via RSS/Atom feeds and Google News. Fetch headlines, search by query, filter by date. Covers football news, transfer rumors, match reports, and any sport via Google News. Use when: user asks for recent news, headlines, transfer rumors, or articles about any sport. Good for "what's the latest on [team/player]" questions. Supports any Google News query and curated RSS feeds (BBC Sport, ESPN, The Athletic, Sky Sports). Don't use when: user asks for structured data like standings, scores, statistics, or xG — use the sport-specific skill instead: football-data (soccer), nfl-data (NFL), nba-data (NBA), wnba-data (WNBA), nhl-data (NHL), mlb-data (MLB), tennis-data (tennis), golf-data (golf), cricket-data (cricket), cfb-data (college football), cbb-data (college basketball), or fastf1 (F1). Don't use for prediction market odds — use polymarket or kalshi. News results are text articles, not structured data.
license
MIT
metadata.author
machina-sports
metadata.version
0.1.0

Sports News

Before writing queries, consult references/api-reference.md for command parameters and references/rss-feeds.md for curated feed URLs.

Quick Start

Prefer the CLI — it avoids Python import path issues:

bash
sports-skills news fetch_items --google_news --query="Arsenal transfer" --limit=5
sports-skills news fetch_feed --url="https://feeds.bbci.co.uk/sport/football/rss.xml"

Python SDK (alternative):

python
from sports_skills import news

articles = news.fetch_items(google_news=True, query="Arsenal transfer news", limit=10)
feed = news.fetch_feed(url="https://feeds.bbci.co.uk/sport/football/rss.xml")

CRITICAL: Before Any Query

CRITICAL: Before calling any news command, verify:

  • Dates are derived from the system prompt's currentDate — never hardcoded.
  • google_news=True is always paired with a query parameter.
  • sort_by_date=True is set for any "recent" or "latest" query.

Choosing Dates

Derive the current date from the system prompt's date (e.g., currentDate: 2026-02-16 means today is 2026-02-16).

  • "this week": after = today - 7 days
  • "recent" or "latest": after = today - 3 days
  • Specific date range: use as-is

Commands

CommandRequiredOptionalDescription
fetch_feedurlFetch an RSS/Atom feed by URL
fetch_itemsgoogle_news, query, url, limit, after, before, sort_by_dateFetch news from Google News or an RSS feed

Workflows

Breaking News Check
  1. fetch_items --google_news --query="<topic>" --limit=5 --sort_by_date=True
  2. Present headlines with source and date.
Topic Deep-Dive
  1. fetch_items --google_news --query="<topic>" --after=<7_days_ago> --sort_by_date=True --limit=10
  2. For curated sources, also try fetch_feed --url="<rss_url>".
  3. Cross-reference both for comprehensive coverage.
Weekly Sports Roundup
  1. For each sport of interest, fetch_items --google_news --query="<sport> results" --after=<7_days_ago> --limit=5.
  2. Aggregate and present by sport.

Examples

Example 1: Transfer news search User says: "What's the latest Arsenal transfer news?" Actions:

  1. Derive after from currentDate: today minus 3 days
  2. Call fetch_items(google_news=True, query="Arsenal transfer news", after=<derived_date>, sort_by_date=True, limit=10) Result: Recent Arsenal transfer headlines with source, date, and links

Example 2: Curated RSS feed User says: "Show me BBC Sport football headlines" Actions:

  1. Call fetch_feed(url="https://feeds.bbci.co.uk/sport/football/rss.xml") Result: BBC Sport football feed title, last updated, and recent articles

Example 3: Date-filtered news User says: "Any Champions League news from this week?" Actions:

  1. Derive after from currentDate: today minus 7 days
  2. Call fetch_items(google_news=True, query="Champions League", after=<derived_date>, sort_by_date=True, limit=10) Result: Champions League articles from the last 7 days, sorted newest first
Show full SKILL.md (164 more words)Show less

Commands that DO NOT exist — never call these

  • get_news — does not exist. Use fetch_feed (for RSS) or fetch_items (for Google News search).
  • search_news — does not exist. Use fetch_items with google_news=True and a query parameter.
  • get_headlines — does not exist. Use fetch_items with google_news=True.

If a command is not listed in the Commands table above, it does not exist.

Troubleshooting

Error: Google News returns empty results Cause: query is missing or too narrow, or google_news=True is not set Solution: Ensure google_news=True AND a query are both set. Try broader keywords (e.g., "Arsenal" instead of "Arsenal vs Chelsea goal")

Error: RSS feed returns an error Cause: The feed URL may be temporarily down or the URL format has changed Solution: Use Google News (fetch_items with google_news=True) as a fallback for the same topic

Error: Articles returned are old despite using "recent" query Cause: sort_by_date=True is not set, or the after date filter is missing Solution: Add sort_by_date=True and after=<today - 3 days> to ensure newest articles appear first

© machina-sports, 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, references) in skills/sports-news of machina-sports/sports-skills.

  • SKILL.md
  • references/api-reference.md
  • references/rss-feeds.md
  • scripts/validate_params.sh

Open the folder on GitHubat commit 09eb7e8

Compare with similar skills

Sports News 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.

Sports News compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sports News this skillmachina-sports/sports-skills243—~1.3kAutomated safety check: PassMIT
Portaljs Add Dcatdatopian/portaljs2.4k1 repos~1.8kAutomated safety check: PassMIT
Audit Contentonvoyage-ai/gtm-engineer-skills1.3k—~1.9kAutomated safety check: PassMIT
Create Geo Chartsonvoyage-ai/gtm-engineer-skills1.3k—~4.3kAutomated safety check: PassMIT
Browsing Linkedinbrowsing-skills/browsing-skills117—~575Automated safety check: PassMIT
SEO Content Refresheraiskillstore/marketplace4337 repos~862Automated safety check: PassNone

Similar skills

  • Portaljs Add Dcat

    datopian/portaljs

    Make a PortalJS portal harvestable by national/EU/US open-data portals — emit standards-compliant DCAT catalog feeds (DCAT 2/3, DCAT-AP, DCAT-US, national profiles) in JSON-LD, Turtle, and RDF/XML…

    2.4k GitHub starsUsed in 1 repo~1.8k tokens
    Marketing & SEOAuto-check passed
  • Audit Content

    onvoyage-ai/gtm-engineer-skills

    Verifies truthfulness, accuracy, and link integrity of content before publishing.

    1.3k GitHub stars~1.9k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Create Geo Charts

    onvoyage-ai/gtm-engineer-skills

    Creates data visualizations (charts, graphs, tables) optimized for AI engine parsing and citation.

    1.3k GitHub stars~4.3k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Browsing Linkedin

    browsing-skills/browsing-skills

    A skill your agent uses when the user wants to interact with LinkedIn — extract post data (content, author, reactions, comments), scrape a member profile (name, headline, experience, education…

    117 GitHub stars~575 tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • SEO Content Refresher

    aiskillstore/marketplace

    Identifies outdated elements in provided content and suggests updates to maintain freshness.

    433 GitHub starsUsed in 7 repos~862 tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed

More from machina-sports/sports-skills

All 23 skills in this repo
  • Cbb Data

    machina-sports/sports-skills

    College Basketball (CBB) data via ESPN public endpoints and the NCAA's official endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, win probability, rankings, futures…

    245 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Cfb Data

    machina-sports/sports-skills

    College Football (CFB) data via ESPN public endpoints and the NCAA's official endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, rankings, injuries, futures…

    245 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Cricket Data

    machina-sports/sports-skills

    Cricket data via ESPN public endpoints and Cricsheet open data — live-ish series scoreboards, standings, match summaries and news (ESPN), plus historical ball-by-ball, player stats, and player…

    245 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Fastf1

    machina-sports/sports-skills

    Formula 1 data — race schedules, results, lap timing, driver and team info.

    245 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Golf Data

    machina-sports/sports-skills

    PGA Tour, LPGA, and DP World Tour golf data via ESPN public endpoints — tournament leaderboards, scorecards, season schedules, golfer profiles/overviews, and news.

    245 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Kalshi

    machina-sports/sports-skills

    Kalshi prediction markets — events, series, markets, trades, and candlestick data.

    245 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Questions about Sports News

What does Sports News do?

Sports news via RSS/Atom feeds and Google News. An agent skill from machina-sports/sports-skills. Sports News is an agent skill from machina-sports/sports-skills. Sports news via RSS/Atom feeds and Google News.

When should I use Sports News?

Sports News fits situations like: : user asks for recent news; transfer rumors; articles about any sport; : user asks for structured data like standings.

How do I install Sports News in Claude Code?

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

How do I install Sports News in Codex?

Run `npx skills add machina-sports/sports-skills --skill sports-news -a codex`. Or copy the skill folder (skills/sports-news in machina-sports/sports-skills) into .agents/skills/sports-news in your project. Codex loads it when a task matches its description.

Can I use Sports News 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 machina-sports/sports-skills --skill sports-news -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sports-news, .gemini/skills/sports-news, .github/skills/sports-news and .opencode/skills/sports-news in your project.

What does Sports News need to run?

Going by SKILL.md and its folder, Sports News needs a shell for the scripts in its folder. Our summary lists: Python 3; A Bash shell.

Does Sports News access the network?

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

Is Sports News 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 Sports News use?

Sports News is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sports News use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 559 tokens, read only when the agent opens those files.

What are the alternatives to Sports News?

Skills that share tags, products or a category with Sports News: Portaljs Add Dcat (datopian/portaljs, 2.4k stars), Audit Content (onvoyage-ai/gtm-engineer-skills, 1.3k stars), Create Geo Charts (onvoyage-ai/gtm-engineer-skills, 1.3k stars) and Browsing Linkedin (browsing-skills/browsing-skills, 117 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sports News?

machina-sports (a GitHub organization) maintains it in machina-sports/sports-skills, which has 243 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 5, 2026.

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