Back to catalog

package-validator

Skill from fstr21/sportsbot

  • Category: discovered
  • Tags: github, community
  • Version: 1.0.0
  • Author: walid
  • Downloads: 0
  • Updated: 2025-11-22

Download the latest version (v1.0.0) from this page.

SKILL.md

# Package Validator Skill

**Purpose**: Validate package JSON files before database ingestion.

## When Claude Should Use This Skill

Use this skill when:
- User says "validate packages" or "check packages"
- Before running ingest stage
- User asks "are packages valid?"
- Debugging package creation issues
- User mentions "package errors" or "bad package data"

## What This Skill Does

1. **Scans** `artifacts/{sport}/packages/{date}/` for JSON files
2. **Validates** JSON structure (parseable, required fields)
3. **Checks** against Pydantic models if available
4. **Compares** package data to raw artifacts (consistency check)
5. **Identifies** missing required fields
6. **Warns** about suspicious values (negative stats, unrealistic odds)
7. **Displays** validation results in table format

## Critical Constraints

- NO emoji (Windows environment)
- Read-only operations
- Handle missing Pydantic models gracefully
- Display clear error messages

## Example Output

```
PACKAGE VALIDATION (NFL 2025-10-23)
+-------------------+--------+--------+
| Package Type      | Valid  | Errors |
+-------------------+--------+--------+
| team_context      |     32 |      0 |
| player_perf       |    280 |      2 |
| matchup_summaries |     14 |      0 |
+-------------------+--------+--------+

VALIDATION ERRORS (2)
[ERROR] player_perf/player_123.json - Missing required field: position_id
[ERROR] player_perf/player_456.json - Invalid value: receiving_yards = -5

[WARN] 2 validation errors found - fix before ingestion
```