{
  "$schema": "https://agentskills.io/schemas/agent-skills-discovery-v0.2.0.json",
  "version": "0.2.0",
  "issuer": "https://saintsfc.com",
  "issued_at": "2025-04-25T00:00:00Z",
  "skills": [
    {
      "name": "get-match-reports",
      "type": "function",
      "description": "Retrieve Southampton FC match reports including scores, stats, goalscorers, and analysis for the 2025/26 season",
      "url": "https://saintsfc.com/match-reports",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "methods": ["GET"],
      "parameters": {
        "type": "object",
        "properties": {
          "format": {
            "type": "string",
            "enum": ["html", "markdown", "rss"],
            "default": "html",
            "description": "Response format"
          }
        }
      },
      "returns": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "homeTeam": { "type": "string" },
            "awayTeam": { "type": "string" },
            "homeScore": { "type": "number" },
            "awayScore": { "type": "number" },
            "competition": { "type": "string" },
            "date": { "type": "string", "format": "date" }
          }
        }
      },
      "examples": [
        {
          "request": "GET /match-reports with Accept: text/markdown",
          "description": "Returns match reports in markdown format"
        }
      ],
      "tags": ["matches", "results", "football"],
      "rate_limit": {
        "requests_per_minute": 60
      }
    },
    {
      "name": "get-fixtures",
      "type": "function",
      "description": "Get upcoming Southampton FC fixtures and completed match results including dates, opponents, and venues",
      "url": "https://saintsfc.com/fixtures",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "methods": ["GET"],
      "parameters": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": ["upcoming", "completed", "all"],
            "default": "all"
          }
        }
      },
      "tags": ["fixtures", "schedule", "matches"],
      "rate_limit": {
        "requests_per_minute": 60
      }
    },
    {
      "name": "get-table-standings",
      "type": "function",
      "description": "Retrieve current EFL Championship table standings with Southampton highlighted, including position, points, and form",
      "url": "https://saintsfc.com/table",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "methods": ["GET"],
      "parameters": {
        "type": "object",
        "properties": {}
      },
      "returns": {
        "type": "object",
        "properties": {
          "position": { "type": "number" },
          "points": { "type": "number" },
          "played": { "type": "number" },
          "wins": { "type": "number" },
          "draws": { "type": "number" },
          "losses": { "type": "number" },
          "goalsFor": { "type": "number" },
          "goalsAgainst": { "type": "number" }
        }
      },
      "tags": ["standings", "championship", "league"],
      "rate_limit": {
        "requests_per_minute": 60
      }
    },
    {
      "name": "get-squad",
      "type": "function",
      "description": "Get Southampton FC first team squad information including players, positions, numbers, and basic stats",
      "url": "https://saintsfc.com/squad",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "methods": ["GET"],
      "parameters": {
        "type": "object",
        "properties": {
          "position": {
            "type": "string",
            "enum": ["Goalkeeper", "Defender", "Midfielder", "Forward", "all"],
            "default": "all"
          }
        }
      },
      "tags": ["players", "squad", "team"],
      "rate_limit": {
        "requests_per_minute": 60
      }
    },
    {
      "name": "get-player-stats",
      "type": "function",
      "description": "Retrieve detailed player statistics for the 2025/26 season including goals, assists, cards, and appearances",
      "url": "https://saintsfc.com/player-stats",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "methods": ["GET"],
      "parameters": {
        "type": "object",
        "properties": {
          "player": {
            "type": "string",
            "description": "Player name or slug"
          }
        }
      },
      "tags": ["statistics", "players", "performance"],
      "rate_limit": {
        "requests_per_minute": 60
      }
    },
    {
      "name": "get-news",
      "type": "function",
      "description": "Get latest Southampton FC news, updates, and club announcements",
      "url": "https://saintsfc.com/news",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "methods": ["GET"],
      "parameters": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "enum": ["Breaking", "Match Report", "Transfer", "Academy", "Interview", "Club News"],
            "description": "Filter by news category"
          },
          "limit": {
            "type": "number",
            "default": 10,
            "maximum": 50
          }
        }
      },
      "tags": ["news", "updates", "club"],
      "rate_limit": {
        "requests_per_minute": 60
      }
    },
    {
      "name": "get-transfer-news",
      "type": "function",
      "description": "Retrieve transfer news, confirmed deals, and rumours for Southampton FC",
      "url": "https://saintsfc.com/transfers",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "methods": ["GET"],
      "parameters": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": ["incoming", "outgoing", "rumours", "all"],
            "default": "all"
          }
        }
      },
      "tags": ["transfers", "signings", "rumours"],
      "rate_limit": {
        "requests_per_minute": 60
      }
    },
    {
      "name": "discover-apis",
      "type": "function",
      "description": "Discover all available APIs and resources via RFC 9727 API Catalog",
      "url": "https://saintsfc.com/.well-known/api-catalog",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "methods": ["GET"],
      "parameters": {
        "type": "object",
        "properties": {}
      },
      "tags": ["discovery", "catalog", "meta"],
      "rate_limit": {
        "requests_per_minute": 30
      }
    }
  ],
  "metadata": {
    "description": "SaintsFC Agent Skills - AI-accessible functions for Southampton FC data",
    "documentation": "https://saintsfc.com/api-docs",
    "terms_of_service": "https://saintsfc.com/terms",
    "contact": {
      "url": "https://saintsfc.com"
    },
    "rate_limits": {
      "default_requests_per_minute": 60,
      "burst_allowance": 10
    },
    "authentication": {
      "required": false,
      "type": "none"
    },
    "content_negotiation": {
      "supported_formats": ["text/html", "text/markdown", "application/rss+xml", "application/json"],
      "default_format": "text/html",
      "format_selection": "Accept header"
    }
  },
  "discovery": {
    "api_catalog": "https://saintsfc.com/.well-known/api-catalog",
    "mcp_server_card": "https://saintsfc.com/.well-known/mcp/server-card.json",
    "openid_configuration": "https://saintsfc.com/.well-known/openid-configuration",
    "oauth_protected_resource": "https://saintsfc.com/.well-known/oauth-protected-resource"
  },
  "_comment": "Agent Skills Discovery RFC v0.2.0 - https://agentskills.io/"
}