How do I install the Tennis Data skill?

Run npx skillmds@latest add tools-only/tennis-data-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tennis Data safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tennis Data?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tennis Data free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Tennis Data?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tennis Data by tools-only — Agent Skill

Name: Tennis Data
Rating: 4.2 (5 reviews)
Author: tools-only

Tennis Data

ATP and WTA tennis data via ESPN public endpoints — tournament scores, season calendars, player rankings, player profiles, and news. Zero config, no API keys. Use when: user asks about tennis scores, match results, tournament draws, ATP/WTA rankings, tennis player info, or tennis news. Don't use when: user asks about other sports. Don't use for live point-by-point data — scores update after each set/match.

tools-only Updated Sep 22, 2026 7 repo stars

File contents

Tennis Data (ATP + WTA)

Quick Start

Prefer the CLI — it avoids Python import path issues:

sports-skills tennis get_scoreboard --tour=atp
sports-skills tennis get_rankings --tour=wta
sports-skills tennis get_calendar --tour=atp --year=2026

Important: Tennis is Not a Team Sport

Tennis data is fundamentally different from team sports (NFL, NBA, etc.):

Tournaments, not games: Events are multi-day tournaments containing many matches.
Individual athletes: Competitors are individual players (singles) or pairs (doubles), not teams.
Set-based scoring: Scores are per-set game counts (e.g., 6-4, 7-5), not quarters.
Rankings, not standings: Players have ATP/WTA ranking points, not team records.
No rosters or team schedules: Tennis has no team-level commands.

The `tour` Parameter

Most commands require --tour=atp or --tour=wta:

ATP: Men's professional tennis tour
WTA: Women's professional tennis tour

If the user doesn't specify, default to atp for men's tennis or wta for women's tennis. If the user just says "tennis" without specifying, ask which tour or show both by calling the command twice.

Before complex fetches, run the parameter validator: bash scripts/validate_params.sh [args]

For detailed reference data, see the files in the references/ directory.

Workflows

Workflow: Live Tournament Check

get_scoreboard --tour=<atp|wta>
Present current matches by round.
For player info, use get_player_info --player_id=<id>.

Workflow: Rankings Lookup

get_rankings --tour=<atp|wta> --limit=20
Present rankings with points and trend.

Workflow: Season Calendar

get_calendar --tour=<atp|wta> --year=<year>
Filter for specific tournament.
get_news --tour=<tour> for latest coverage.

Examples

User: "What ATP matches are happening right now?"

Call get_scoreboard(tour="atp")
Present current tournaments and matches by round

User: "Show me the WTA rankings"

Call get_rankings(tour="wta", limit=20)
Present rankings with rank, name, points, and trend

User: "When is the French Open this year?"

Call get_calendar(tour="atp", year=2026)
Search results for "Roland Garros" (the French Open's official name)

Error Handling & Fallbacks

If get_scoreboard returns no matches, tournaments run specific weeks. Use get_calendar to find when events are scheduled.
If rankings are empty, rankings update weekly on Mondays. The command auto-retries previous weeks.
If player profile fails, use get_rankings to verify the player_id.
Never fabricate match scores or rankings. If data is unavailable, state so.

---name: tennis-data-2description: ATP and WTA tennis data via ESPN public endpoints — tournament scores, season calendars, player rankings, player profiles, and news. Zero config, no API keys. Use when: user asks about tennis scores, match results, tournament draws, ATP/WTA rankings, tennis player info, or tennis news. Don't use when: user asks about other sports. Don't use for live point-by-point data — scores update after each set/match.license: MIT---# Tennis Data (ATP + WTA)## Quick StartPrefer the CLI — it avoids Python import path issues:```bashsports-skills tennis get_scoreboard --tour=atpsports-skills tennis get_rankings --tour=wtasports-skills tennis get_calendar --tour=atp --year=2026```## Important: Tennis is Not a Team SportTennis data is fundamentally different from team sports (NFL, NBA, etc.):- **Tournaments, not games**: Events are multi-day tournaments containing many matches.- **Individual athletes**: Competitors are individual players (singles) or pairs (doubles), not teams.- **Set-based scoring**: Scores are per-set game counts (e.g., 6-4, 7-5), not quarters.- **Rankings, not standings**: Players have ATP/WTA ranking points, not team records.- **No rosters or team schedules**: Tennis has no team-level commands.## The `tour` ParameterMost commands require `--tour=atp` or `--tour=wta`:- **ATP**: Men's professional tennis tour- **WTA**: Women's professional tennis tourIf the user doesn't specify, default to `atp` for men's tennis or `wta` for women's tennis. If the user just says "tennis" without specifying, ask which tour or show both by calling the command twice.Before complex fetches, run the parameter validator: `bash scripts/validate_params.sh [args]`*For detailed reference data, see the files in the `references/` directory.*## Workflows### Workflow: Live Tournament Check1. `get_scoreboard --tour=<atp|wta>`2. Present current matches by round.3. For player info, use `get_player_info --player_id=<id>`.### Workflow: Rankings Lookup1. `get_rankings --tour=<atp|wta> --limit=20`2. Present rankings with points and trend.### Workflow: Season Calendar1. `get_calendar --tour=<atp|wta> --year=<year>`2. Filter for specific tournament.3. `get_news --tour=<tour>` for latest coverage.## ExamplesUser: "What ATP matches are happening right now?"1. Call `get_scoreboard(tour="atp")`2. Present current tournaments and matches by roundUser: "Show me the WTA rankings"1. Call `get_rankings(tour="wta", limit=20)`2. Present rankings with rank, name, points, and trendUser: "When is the French Open this year?"1. Call `get_calendar(tour="atp", year=2026)`2. Search results for "Roland Garros" (the French Open's official name)## Error Handling & Fallbacks- If `get_scoreboard` returns no matches, tournaments run specific weeks. Use `get_calendar` to find when events are scheduled.- If rankings are empty, rankings update weekly on Mondays. The command auto-retries previous weeks.- If player profile fails, use `get_rankings` to verify the player_id.- **Never fabricate match scores or rankings.** If data is unavailable, state so.

Frequently asked questions