{
  "name": "XKCD Comic Agent",
  "description": "A minimal A2A agent that fetches and displays XKCD comics with intelligent search capabilities.",
  "version": "1.0.0",
  "provider": {
    "organization": "XKCD Agent",
    "contact": "info@xkcd-agent.local"
  },
  "url": "http://localhost:8080/agent",
  "documentationUrl": "http://localhost:8080/health",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": true
  },
  "authentication": {
    "schemes": ["bearer", "none"]
  },
  "defaultInputModes": ["text"],
  "defaultOutputModes": ["text", "data"],
  "skills": [
    {
      "id": "latest-comic",
      "name": "Latest Comic Retrieval",
      "description": "Fetches the most recent XKCD comic with title, alt text, and image",
      "tags": ["latest", "current", "newest"],
      "examples": ["latest", "current", "newest", "what's new"],
      "inputModes": ["text"],
      "outputModes": ["text", "data"]
    },
    {
      "id": "random-comic",
      "name": "Random Comic Discovery",
      "description": "Selects a random comic from the entire XKCD archive",
      "tags": ["random", "discovery", "surprise"],
      "examples": ["random", "surprise me", "pick one"],
      "inputModes": ["text"],
      "outputModes": ["text", "data"]
    },
    {
      "id": "specific-comic",
      "name": "Specific Comic Access",
      "description": "Retrieves any XKCD comic by its ID number",
      "tags": ["specific", "id", "number"],
      "examples": ["353", "comic 42", "show me number 1234", "xkcd 271"],
      "inputModes": ["text"],
      "outputModes": ["text", "data"]
    },
    {
      "id": "search-comics",
      "name": "Intelligent Content Search", 
      "description": "Searches through comic titles and alt text to find relevant comics by topic",
      "tags": ["search", "find", "topic", "content"],
      "examples": ["search python", "find machine learning", "about programming"],
      "inputModes": ["text"],
      "outputModes": ["text", "data"]
    },
    {
      "id": "error-recovery",
      "name": "Error Recovery",
      "description": "Gracefully handles network errors and invalid requests with helpful fallbacks",
      "tags": ["error", "recovery", "fallback"],
      "examples": ["comic 99999", "search nonexistent topic"],
      "inputModes": ["text"],
      "outputModes": ["text"]
    }
  ],
  "metadata": {
    "categories": [
      "Entertainment",
      "Programming",
      "Science",
      "Technology",
      "Humor"
    ],
    "tags": [
      "xkcd",
      "comics",
      "programming-humor",
      "science-jokes",
      "webcomics",
      "search"
    ],
    "performance": {
      "averageResponseTime": "2-5 seconds",
      "searchResponseTime": "5-30 seconds",
      "cacheSupport": false,
      "rateLimits": "Respectful API usage"
    },
    "requirements": {
      "internetAccess": true,
      "externalAPIs": [
        {
          "name": "XKCD API",
          "url": "https://xkcd.com/info.0.json",
          "description": "Official XKCD JSON API for comic data"
        }
      ]
    },
    "examples": [
      {
        "input": "latest",
        "description": "Get the most recent XKCD comic",
        "expectedOutput": "Comic title, number, and alt text with image"
      },
      {
        "input": "random",
        "description": "Discover a random comic from the archive",
        "expectedOutput": "Random comic with full details"
      },
      {
        "input": "353",
        "description": "Get a specific comic by ID",
        "expectedOutput": "XKCD #353: Python comic"
      },
      {
        "input": "search python",
        "description": "Find comics about Python programming",
        "expectedOutput": "Matching comic with relevant content"
      }
    ],
    "created": "2025-06-16",
    "lastUpdated": "2025-06-16",
    "language": "en",
    "license": "MIT"
  }
}