Football Tracker Match & News AI

SKILL.md

---
name: football-tracker
description: Track football teams and return last match, next match, kickoff time, broadcasters, standings, and recent news in a compact emoji-formatted summary.
---

# Football Tracker AI

Track football teams and summarize their current status in a compact, emoji-friendly format.

This skill is bilingual:

- English is supported for instructions and output.
- Portuguese (pt-BR) remains supported for the existing Telegram style.
- The agent can force a locale with `locale=en`, `lang=en`, `locale=pt`, or `lang=pt`.

## Usage

- One team: `vasco`
- Multiple teams: `vasco, chelsea, bournemouth`
- Force English output: `locale=en Chelsea`
- Force Portuguese output: `locale=pt Chelsea`

## Expected output

For each team, return:

- team name
- last match
- next match
- kickoff time in the user's local timezone when available, plus UTC
- broadcasters / where-to-watch info for the next match when available
- competition
- standings
- recent news

## Dependencies

- No extra Python packages are required.
- Uses only the Python standard library.
- Requires a valid `API_KEY` from `football-data.org` in `storage/user_config.json`.

## First Use

- If no API key is stored for the user, ask for `set_api_key SUA_KEY`.
- Keep support for `API_KEY:` as a silent compatibility fallback if needed, but do not suggest it to the user.
- Make it explicit that the user can send the key and you will complete the setup for them.
- Keep the setup flow internal to the skill; do not require the user to search for external instructions.
- After the key is stored, continue with the normal team lookup flow.

## Notes

- If the data source cannot confidently resolve a team, return `N/A` for missing match data and still provide news.
- Keep the user-facing output in the requested locale and preserve the emoji-based layout.
- Always show kickoff time in the local timezone plus UTC.
- Always include the weekday in the kickoff timestamp.
- If broadcaster data is unavailable, say so rather than guessing.
- News results are filtered to exclude previews, lineups, kickoff-time posts, and where-to-watch articles.
- News results are also filtered to avoid non-football categories like base teams, futsal, rowing, basketball, and women's sections.
- Append a localized beta notice and the current version at the end of every result.
- This build focuses on bug fixes and discovery improvements.
- If timezone detection is unavailable, fall back to the machine/system timezone.

## Language packs

- `references/locales/en.md` for the English output pack
- `references/locales/pt-br.md` for the Portuguese output pack