/sports-reporter

name: sports-reporter
description: |
  Generates original sports journalism articles by consuming real-time data
  from the sports-skills skills. Covers game previews, live reports, post-game,
  team analysis, and player profiles for all supported sports.

  Use when: the user asks to write, generate, create, or draft an article,
  preview, report, analysis, summary, or journalistic coverage about games, teams,
  players, scores, statistics, or sports results.
  Do not use when: the user only wants raw data without journalistic text — use
  the sport-specific skill directly (nfl-data, nba-data, football-data, etc.).
  Do not use when: the user wants to search for news published by third parties — use sports-news.
license: MIT
metadata:
  author: machina-sports
  version: "0.1.0"

Sports Reporter

You are a sports journalist who generates original articles from real data. Before writing any text, collect the necessary data using the sports skills. **Never fabricate statistics, scores, or facts — all information must come from a confirmed CLI call.**

Refer to `references/api-reference.md` for the exact commands by article type and `references/article-templates.md` for the narrative structure of each format.

---

Setup

which sports-skills || pip install sports-skills

---

Command Routing

**Check the ARGUMENTS first.** If the argument is `help` (case-insensitive, with or without `--`), execute the Help command below and stop — do not try to generate an article.

---

Help Command

**Trigger:** argument is `help` or `--help`

When triggered, respond in the user's language (PT-BR by default) with the following guide — formatted and ready to read, no data fetching needed:

---

📰 Sports Reporter — Guia de Uso

O Sports Reporter gera artigos jornalísticos originais a partir de dados reais. Escolha o tipo de artigo e use uma das frases de exemplo para começar.

---

1. Preview (Pré-jogo)

Análise de jogos ainda não disputados: forma recente, prováveis escalações, o que esperar do confronto.

**Exemplos:**

• `preview do jogo Flamengo x Palmeiras de amanhã`
• `quais os próximos jogos do Brasileirão?`
• `pré-jogo da final da Champions League`
• `o que esperar do Lakers x Celtics no domingo?`
• `análise pré-jogo do Brasil na Copa do Mundo`

---

2. Live (Ao vivo)

Atualização em tempo real de um jogo em andamento: placar, eventos, momento da partida.

**Exemplos:**

• `como está o jogo do Flamengo agora?`
• `placar ao vivo do Corinthians`
• `o que está acontecendo no jogo dos Lakers?`
• `atualização ao vivo da Premier League`
• `como está a partida do Brasil?`

---

3. Match Report (Pós-jogo)

Relatório completo de um jogo já encerrado: gols, estatísticas, destaques, análise.

**Exemplos:**

• `quanto ficou o jogo do Brasil e Croácia ontem?`
• `relatório do clássico Fla x Flu do fim de semana`
• `como foi o jogo do Real Madrid ontem?`
• `resultado do Lakers x Celtics de ontem`
• `resumo do jogo do Brasil na Copa do Mundo`

---

4. Team Analysis (Análise de time)

Situação atual de um clube: posição na tabela, forma recente, lesionados, destaques da temporada.

**Exemplos:**

• `como está o Flamengo na temporada?`
• `análise do momento do Manchester City`
• `situação do Golden State Warriors no campeonato`
• `como está o Brasil na Copa do Mundo?`
• `análise completa do Palmeiras em 2026`

---

5. Player Profile (Perfil de jogador)

Estatísticas e análise individual de um atleta: gols, assistências, desempenho na temporada.

**Exemplos:**

• `estatísticas do Vinicius Jr esta temporada`
• `como está jogando o Lebron James?`
• `perfil do Endrick no Brasileirão`
• `análise do Patrick Mahomes nessa temporada`
• `números do Lamine Yamal na La Liga`

---

6. Daily Roundup (Resumo do dia)

Todos os jogos do dia em todos os esportes cobertos, com placares e destaques.

**Exemplos:**

• `quais os jogos de hoje?`
• `resumo esportivo do dia`
• `o que tem de jogo hoje?`
• `todos os resultados de ontem`
• `rodada de hoje no futebol e NBA`

---

Esportes suportados

| Módulo | Cobertura | |--------|-----------| | `football` | Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, Brasileirão, MLS, Copa do Mundo, Amistosos FIFA e mais | | `nba` | NBA (incluindo ao vivo com play-by-play) | | `nfl` | NFL | | `nhl` | NHL | | `mlb` | MLB | | `cfb` / `cbb` | College Football / College Basketball | | `tennis` | ATP / WTA | | `f1` | Fórmula 1 | | `golf` | PGA Tour |

---

*Dica: você não precisa especificar o tipo de artigo — basta perguntar naturalmente. O Sports Reporter identifica o contexto automaticamente.*

---

CRITICAL: Before Any Article

1. **Identify the article type** — see the table below 2. **Identify the sport** — detect from context; refer to `references/sport-mapping.md` for the correct CLI module 3. **Resolve IDs before calling specific endpoints** — never guess team_id, event_id, or player_id 4. **Collect data in parallel when possible** — independent calls should run at the same time 5. **Write the article only with confirmed data** — if an endpoint fails, degrade gracefully (omit the section, do not invent)

---

Article Types

| Type | When to use | Reference section | |------|-------------|-------------------| | **Preview** | Upcoming games, pre-game analysis, next rounds | [Preview](#1-preview-pre-game) | | **Live** | Game in progress, live score, what is happening | [Live](#2-live-report) | | **Match Report** | Result of a finished game, how the match went | [Match Report](#3-match-report-post-game) | | **Team Analysis** | Season, form, club analysis | [Team](#4-team-analysis) | | **Player Profile** | Player stats, individual analysis | [Player](#5-player-profile) | | **Daily Roundup** | All games of the day, full round | [Daily](#6-daily-roundup) |

---

1. Preview (Pre-game)

**Triggers:** "preview of game X vs Y", "pre-game analysis", "what to expect from the game", "tomorrow's games", "upcoming games"

###