Use this skill when the user asks about German U19 badminton rankings, player statistics, ranking history, or wants to explore badminton data. This skill enables interaction with the `badminton-cli` tool for querying the German Badminton Association (DBV) U19 rankings.
Queries German U19 badminton rankings and player statistics using the badminton-cli tool.
/plugin marketplace add pmatos/badminton-cli/plugin install badminton-cli@badminton-cliThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Use this skill when the user asks about German U19 badminton rankings, player statistics, ranking history, or wants to explore badminton data. This skill enables interaction with the badminton-cli tool for querying the German Badminton Association (DBV) U19 rankings.
Before using any badminton-cli commands, verify the tool is installed:
which badminton-cli || echo "NOT_INSTALLED"
If NOT_INSTALLED, install it:
uv tool install badminton-cli
Or with pipx:
pipx install badminton-cli
All commands support --json flag for structured output. Always use --json when you need to process the data programmatically.
Download and index the latest ranking data from DBV:
badminton-cli update
Options:
--all: Download all historical ranking weeks--force: Force re-download of all filesRun this first if data hasn't been downloaded yet.
Fuzzy search for players by name:
badminton-cli search "Max Mustermann" --json
Options:
--limit, -n: Maximum results (default: 10)JSON output structure:
[
{
"player_id": "01-150083",
"name": "Max Mustermann",
"fuzzy_score": 95.5,
"club": "BC Example",
"best_rank": 5,
"best_discipline": "HE"
}
]
Show detailed information for a specific player:
badminton-cli player 01-150083 --json
Options:
--week, -w: Specific ranking week (e.g., 'KW2', '2026-KW02')--age-rank, -a: Include rank within player's age groupJSON output structure:
{
"player_id": "01-150083",
"full_name": "Max Mustermann",
"birth_year": 2008,
"club": "BC Example",
"district": "Bayern",
"age_class_1": "U17",
"age_class_2": "U19",
"ranking_week": "KW 2 2026",
"rankings": [
{
"discipline": "HE",
"rank": 15,
"federation_rank": 25,
"points": 3500.5,
"tournaments": 12,
"age_group_rank": 8
}
]
}
Side-by-side comparison of two players:
badminton-cli compare 01-150083 01-150084 --json
Options:
--week, -w: Specific ranking weekCalculate combined points for a doubles partnership:
badminton-cli team 01-150083 01-150084 --json
Options:
--discipline, -d: Filter to specific doubles (HD, DD, HM, DM)--week, -w: Specific ranking weekJSON output structure:
{
"player1": {"player_id": "01-150083", "full_name": "Max Mustermann"},
"player2": {"player_id": "01-150084", "full_name": "Erika Musterfrau"},
"team": [
{
"discipline": "HM",
"player1_points": 2500.0,
"player2_points": 2200.0,
"team_total": 4700.0
}
]
}
Show top-ranked players:
badminton-cli top --discipline HE --limit 20 --json
Options:
--discipline, -d: Filter by discipline (HE, HD, DE, DD, HM, DM)--limit, -n: Number of results (default: 20)--week, -w: Specific ranking week--age-rank, -a: Include age-group ranksGet historical ranking data for visualization:
badminton-cli graph 01-150083 --discipline HE --json
Options:
--discipline, -d: Specific discipline--points, -p: Show points instead of rank--since, -s: Time filter ('1y', '6m', '3m')--age-rank, -a: Show age-group rank progressionJSON output structure:
{
"discipline": "HE",
"y_axis": "rank",
"players": [
{
"name": "Max Mustermann",
"data": [
{"week": 2, "year": 2026, "label": "KW 2 2026", "rank": 10, "points": 3500.5}
]
}
]
}
List all indexed ranking weeks:
badminton-cli history --json
| Code | Full Name | English |
|---|---|---|
| HE | Herren Einzel | Men's Singles |
| DE | Damen Einzel | Women's Singles |
| HD | Herren Doppel | Men's Doubles |
| DD | Damen Doppel | Women's Doubles |
| HM | Herren Mixed | Mixed (male player) |
| DM | Damen Mixed | Mixed (female player) |
badminton-cli search "name" --jsonbadminton-cli player <id> --jsonbadminton-cli graph <id1> <id2> --discipline HE --since 6m --jsonIf commands fail with "No data available":
badminton-cli update to download ranking dataIf a player is not found:
Use when working with Payload CMS projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Use when debugging validation errors, security issues, relationship queries, transactions, or hook behavior.