Brand and Design Toolkit
nextlevelbuilder/ui-ux-pro-max-skill
Bundles design tasks behind one skill: brand identity, tokens, UI styling, logos, corporate identity mockups, slides, banners, icons and social images.
Sports metadata via TheSportsDB free API (key=3). An agent skill from machina-sports/sports-skills.
Install Metadata
$ npx skills add machina-sports/sports-skills --skill metadata -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install machina-sports/sports-skills metadata --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/machina-sports/sports-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/metadata .claude/skills/metadata && rm -rf skills-srcUse ~/.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/
Install the "metadata" agent skill from https://github.com/machina-sports/sports-skills/tree/main/skills/metadata into .claude/skills/metadata/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "metadata", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/machina-sports/sports-skills/tree/main/skills/metadataType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add machina-sports/sports-skills --skill metadata -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install machina-sports/sports-skills metadata --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/machina-sports/sports-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/metadata .agents/skills/metadata && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "metadata" agent skill from https://github.com/machina-sports/sports-skills/tree/main/skills/metadata into .agents/skills/metadata/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "metadata", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add machina-sports/sports-skills --skill metadata -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install machina-sports/sports-skills metadata --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/machina-sports/sports-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/metadata .cursor/skills/metadata && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "metadata" agent skill from https://github.com/machina-sports/sports-skills/tree/main/skills/metadata into .cursor/skills/metadata/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "metadata", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/machina-sports/sports-skills.git --path skills/metadata--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add machina-sports/sports-skills --skill metadata -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install machina-sports/sports-skills metadata --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/machina-sports/sports-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/metadata .gemini/skills/metadata && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "metadata" agent skill from https://github.com/machina-sports/sports-skills/tree/main/skills/metadata into .gemini/skills/metadata/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "metadata", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install machina-sports/sports-skills metadataInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add machina-sports/sports-skills --skill metadata -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/machina-sports/sports-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/metadata .github/skills/metadata && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "metadata" agent skill from https://github.com/machina-sports/sports-skills/tree/main/skills/metadata into .github/skills/metadata/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "metadata", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add machina-sports/sports-skills --skill metadata -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install machina-sports/sports-skills metadata --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/machina-sports/sports-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/metadata .opencode/skills/metadata && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "metadata" agent skill from https://github.com/machina-sports/sports-skills/tree/main/skills/metadata into .opencode/skills/metadata/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "metadata", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
metadata- GitHub stars
- 243
- Token cost
- ~1.8k tokens
- SKILL.md length
- 758 words
- Files
- 1
- Skills in repo
- 23
- Repo updated
- First seen
- Licence
- MIT
At a glance
Sports metadata via TheSportsDB free API (key=3). An agent skill from machina-sports/sports-skills.
- Works in 3 steps: Call the sport-specific skill (e.g.,… → For each team in the standings, call… → Render the standings with logos…
- : user asks for a team logo
- SKILL.md covers Quick Start, CRITICAL: Before Any Query, Coverage and Commands, plus 4 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Metadata is an agent skill from machina-sports/sports-skills. Sports metadata via TheSportsDB free API (key=3). Team logos and badges, player photos, stadium info, league info, and biographical data across 100+ leagues. No API key required, zero config. Use when: user asks for a team logo, crest, badge, banner, jersey, kit, player photo or headshot, stadium info, club description, or wants to search for teams or players by name across sports. Good for enriching responses from other skills with images and visual identifiers. Don't use when: user asks for scores, standings…
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Media & Creative, covering Logo and visual identity. 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 a team logo
- Club description
- Wants to search for teams
- Players by name across sports
Example prompts
- “Use the metadata skill to sport metadata via TheSportsDB free API (key=3). An agent skill from machina-sports/sports-skills”
- “/metadata”
Requirements
- Python 3
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Call the sport-specific skill (e.g., football get_season_standings) for the standings table.
- For each team in the standings, call get_team_logo --team_name= to attach a badge URL.
- Render the standings with logos alongside team names.
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
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and python).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
thesportsdb.com
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
Metadata loads about 1.8k tokens when it runs. Until then it costs about 239 tokens; SKILL.md has 758 words of instructions outside code blocks.
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); files beside SKILL.md are not scanned.
SKILL.md
The full file from machina-sports/sports-skills at commit 09eb7e8, republished under its MIT licence (© machina-sports). 758 words, ~1,803 tokens.
Download SKILL.mdSave it as
.claude/skills/metadata/SKILL.md (or your agent's skills folder).- name
- metadata
- description
- Sports metadata via TheSportsDB free API (key=3). Team logos and badges, player photos, stadium info, league info, and biographical data across 100+ leagues. No API key required, zero config. Use when: user asks for a team logo, crest, badge, banner, jersey, kit, player photo or headshot, stadium info, club description, or wants to search for teams or players by name across sports. Good for enriching responses from other skills with images and visual identifiers. Don't use when: user asks for scores, standings, fixtures, stats, or odds — 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), fastf1 (F1), volleyball-data (Dutch volleyball), xctf-data (NCAA XC/TF). Don't use for prediction markets — use polymarket or kalshi.
- license
- MIT
- metadata.author
- machina-sports
- metadata.version
- 0.1.0
Sports Metadata
Wraps the free TheSportsDB API for team logos, player photos, and stadium info. No API key, no signup.
Quick Start
sports-skills metadata get_team_logo --team_name="Arsenal"
sports-skills metadata get_team_info --team_name="Real Madrid"
sports-skills metadata get_player_photo --player_name="Messi"
sports-skills metadata search_teams --query="Manchester"
sports-skills metadata search_players --query="LeBron"Python SDK:
from sports_skills import metadata
metadata.get_team_logo(team_name="Arsenal")
metadata.get_team_info(team_name="Real Madrid")
metadata.get_player_photo(player_name="Messi")
metadata.search_teams(query="Manchester")
metadata.search_players(query="LeBron")CRITICAL: Before Any Query
CRITICAL: Before calling any metadata command, verify:
- Team names use the full official name — especially for NBA (e.g.,
"Los Angeles Lakers", not"Lakers"). - For
get_team_logo, thesportparameter defaults to"Soccer". Passsport="Basketball","American Football","Baseball","Ice Hockey","Motorsport", or"Cricket"when the team is not a soccer team — otherwise the lookup falls back to a close name match in any sport. If no result is close to the requested name, it returns an error listing what TheSportsDB offered. - Player searches use just the player name (e.g.,
"Messi","LeBron James","Tiger Woods").
Coverage
Teams (logos, banners, stadium info):
- Soccer: 100+ leagues worldwide (Premier League, La Liga, Bundesliga, Serie A, MLS, and many more)
- NFL (American Football)
- NBA (Basketball) — requires full team names
- MLB (Baseball)
- NHL (Ice Hockey)
- F1 (Motorsport)
- Cricket (IPL, international)
Players (photos, bios):
- All team sports above
- Tennis (ATP/WTA players)
- Golf (PGA/LPGA players)
Not covered: MMA/UFC, Rugby, Esports, Boxing.
Commands
| Command | Required | Optional | Description |
|---|---|---|---|
get_team_logo | team_name | sport | Team logo / badge URL |
get_team_info | team_name | Full team info: stadium, description, social links, banner | |
get_player_photo | player_name | Player photo URL | |
search_teams | query | Fuzzy search for teams across sports | |
search_players | query | Fuzzy search for players across sports |
Workflows
Enrich a Standings Response
- Call the sport-specific skill (e.g.,
football get_season_standings) for the standings table. - For each team in the standings, call
get_team_logo --team_name=<name>to attach a badge URL. - Render the standings with logos alongside team names.
Build a Team Profile Page
- Call
get_team_info --team_name="<name>"for stadium, description, founding year, social links. - The same response includes
badgeandbannerURLs — no second call needed.
Resolve an Ambiguous Team Name
- Call
search_teams --query="<partial-name>"to disambiguate. - Use the exact
namefield from the result for follow-upget_team_infocalls.
Examples
Example 1: Get a Premier League team logo User says: "What does the Arsenal logo look like?" Actions:
- Call
get_team_logo(team_name="Arsenal")—sportdefaults to "Soccer", which is correct here. Result: Logo URL, sport, league, and country.
Example 2: NBA team — full name required User says: "Get the Lakers logo" Actions:
- Call
get_team_logo(team_name="Los Angeles Lakers", sport="Basketball")— both the full name AND the sport filter are needed. Result: Lakers badge from the NBA branch of TheSportsDB.
Example 3: Player photo User says: "Show me a photo of Messi" Actions:
- Call
get_player_photo(player_name="Messi"). Result: Player photo URL, sport, team, and nationality.
Example 4: Disambiguate "Manchester" User says: "Find me Manchester teams" Actions:
- Call
search_teams(query="Manchester"). Result: List of teams matching "Manchester" — Manchester United, Manchester City, etc. — each with sport, league, and country.
Show full SKILL.md (311 more words)Show less
Commands that DO NOT exist — never call these
get_stadium_infoget_team_info.get_league_logoget_team_logofor team badges only.get_player_statsfootball get_player_profile,nba get_player_stats).search_leagues
If a command is not listed in the Commands table above, it does not exist.
Troubleshooting
Error: get_team_logo returns the wrong team
Cause: A short or ambiguous team name (e.g., "Lakers", "Arsenal") matched a different sport first
Solution: Pass an explicit sport parameter and use the team's full official name
Error: get_team_logo / get_team_info say "No team named ... found"
Cause: TheSportsDB's free search returned only teams whose names are not close to the query (e.g. "St. Louis Cardinals" -> "Louisville")
Solution: Use the team's full official name, or search_teams --query=<partial> to find it
Error: get_player_photo returns null / empty
Cause: Player not in TheSportsDB, or the name spelling differs (e.g., "Cristiano Ronaldo" vs "Ronaldo")
Solution: Use search_players --query=<partial> first to find the canonical spelling, then retry
Error: Logo URL works but the image is low resolution Cause: TheSportsDB returns the badge as-is from contributors Solution: This is an upstream limitation. Most badges are 200×200 or larger; very small icons indicate a low-quality submission. No workaround.
Error: "TheSportsDB rate limit: the free API key allows 30 requests per minute" (status_code: 429)
Cause: The free key answers HTTP 429 from the 31st request in a minute, then locks out for about 2 minutes. The client paces itself below that (bursts of 5, then about one request every 2.4 s), so this error means a long batch outran the pacing or another process shares the key
Solution: Wait for the time in the message, then retry. Repeated lookups are cached for 5 minutes, so reuse earlier results rather than re-querying in a loop
© 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
Just SKILL.md in skills/metadata of machina-sports/sports-skills.
Open the folder on GitHubat commit 09eb7e8
Compare with similar skills
Metadata 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Metadata this skillmachina-sports/sports-skills | 243 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Brand and Design Toolkitnextlevelbuilder/ui-ux-pro-max-skill | 135k | 1 repos | ~3.5k | Automated safety check: Pass | MIT | |
| Anthropic Brand Stylinganthropics/skills | 180k | 30 repos | ~559 | Automated safety check: Pass | Apache-2.0 | |
| Logo Designkaankiziltug/logo-design-skill | 2.5k | — | ~4.4k | Automated safety check: Pass | MIT | |
| Logo Generatorop7418/logo-generator-skill | 2.2k | — | ~1.8k | Automated safety check: Notes | None | |
| Web Asset Generatoralonw0/web-asset-generator | 514 | 1 repos | ~6.6k | Automated safety check: Pass | MIT |
Similar skills
- Official
Anthropic Brand Styling
anthropics/skills
Applies Anthropic's brand colors and fonts to artifacts such as PowerPoint slides, using fixed hex values for text and accents, Poppins headings and Lora body text.
Logo Design
kaankiziltug/logo-design-skill
Professional logo and brand-mark design, from brief to production files.
Logo Generator
op7418/logo-generator-skill
Generate professional SVG logos and high-end showcase images.
Web Asset Generator
alonw0/web-asset-generator
Generate web assets including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn.
Image Generation
onyx-dot-app/onyx
Generate or edit raster images (photos, illustrations, textures, sprites, mockups, logos, infographics) using the workspace's configured image-generation provider via onyx-cli image.
More from machina-sports/sports-skills
All 23 skills in this repoCbb 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…
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…
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…
Fastf1
machina-sports/sports-skills
Formula 1 data — race schedules, results, lap timing, driver and team info.
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.
Kalshi
machina-sports/sports-skills
Kalshi prediction markets — events, series, markets, trades, and candlestick data.
Related
Works with
Categories
Questions about Metadata
What does Metadata do?
Sports metadata via TheSportsDB free API (key=3). An agent skill from machina-sports/sports-skills. Metadata is an agent skill from machina-sports/sports-skills. Sports metadata via TheSportsDB free API (key=3).
When should I use Metadata?
Metadata fits situations like: : user asks for a team logo; club description; wants to search for teams; players by name across sports.
How do I install Metadata in Claude Code?
Run `npx skills add machina-sports/sports-skills --skill metadata -a claude-code`. Or copy the skill folder (skills/metadata in machina-sports/sports-skills) into .claude/skills/metadata in your project. Claude Code loads it when a task matches its description.
How do I install Metadata in Codex?
Run `npx skills add machina-sports/sports-skills --skill metadata -a codex`. Or copy the skill folder (skills/metadata in machina-sports/sports-skills) into .agents/skills/metadata in your project. Codex loads it when a task matches its description.
Can I use Metadata 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 metadata -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/metadata, .gemini/skills/metadata, .github/skills/metadata and .opencode/skills/metadata in your project.
What does Metadata need to run?
SKILL.md names no scripts, command-line tools or credentials: Metadata is instructions for the agent only. Our summary lists: Python 3.
Does Metadata access the network?
SKILL.md names 1 domain. As links in the text: thesportsdb.com. This is read from the text; nothing was executed.
Is Metadata 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. Review the folder before installing.
What licence does Metadata use?
Metadata 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 Metadata use?
About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Metadata?
Skills that share tags, products or a category with Metadata: Brand and Design Toolkit (nextlevelbuilder/ui-ux-pro-max-skill, 135k stars), Anthropic Brand Styling (anthropics/skills, 180k stars), Logo Design (kaankiziltug/logo-design-skill, 2.5k stars) and Logo Generator (op7418/logo-generator-skill, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Metadata?
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.