{
  "$schema": "https://agentskills.io/schema/v0.2.0",
  "skills": [
    {
      "name": "content-negotiation",
      "type": "text/markdown",
      "description": "Request any page as Markdown by sending Accept: text/markdown",
      "url": "https://subhbits.com/.well-known/agent-skills/markdown-negotiation/SKILL.md",
      "sha256": "ab668b9dfc489df8353d82b42c398617730e417b5d6088558f25f0020aef1991"
    },
    {
      "name": "blog-content",
      "type": "mcp",
      "description": "Access blog posts and metadata via MCP server",
      "url": "https://subhbits.com/.well-known/mcp/server-card.json",
      "sha256": "74748ac0f34e8ee7cec54f45001ede95610b548600726bf97d165ea5fc7a0d57"
    },
    {
      "name": "api-catalog",
      "type": "api",
      "description": "Discover available APIs including GraphQL, contact, and newsletter endpoints",
      "url": "https://subhbits.com/.well-known/api-catalog",
      "sha256": "c35fd240013253e57bef0b3084441dacaa9c289b0021e7114034aee77d1ed50c"
    },
    {
      "name": "openapi-spec",
      "type": "api",
      "description": "Full OpenAPI 3.1 specification for all REST endpoints. Use this to auto-generate clients, explore the API surface, or build function-calling tool definitions.",
      "url": "https://subhbits.com/api/openapi.json"
    }
  ],
  "whenToUse": {
    "lookUpBlogPost": "Use the blog-content MCP server or GraphQL API to retrieve posts by slug, tag, or series. Send Accept: text/markdown for a clean text version.",
    "searchContent": "Use the searchPosts GraphQL query for semantic search across all published posts.",
    "subscribeUser": "POST to /api/newsletter with an email address. The subscription is pending until confirmed via email.",
    "sendContactMessage": "POST to /api/contact with name, email, and message (minimum 10 characters).",
    "exploreAPI": "Fetch /api/openapi.json for the full OpenAPI 3.1 specification with typed schemas and operation IDs.",
    "getCitationReadyContent": "Request any page with Accept: text/markdown header for a clean, machine-readable version suitable for citations."
  }
}
