{
  "specVersion": "1.0",
  "host": {
    "displayName": "sudohulk.com",
    "identifier": "https://sudohulk.com",
    "documentationUrl": "https://sudohulk.com/for-ai"
  },
  "entries": [
    {
      "identifier": "urn:air:sudohulk.com:mcp:server-card",
      "displayName": "sudohulk.com MCP server",
      "description": "A public, stateless MCP server that searches, lists and reads the site as markdown: posts and notes on computer science and database internals, projects, and tracks.",
      "type": "application/mcp-server-card+json",
      "url": "https://sudohulk.com/.well-known/mcp/server-card.json",
      "tags": [
        "mcp",
        "postgresql",
        "databases",
        "computer science"
      ],
      "representativeQueries": [
        "search sudohulk.com for notes on PostgreSQL full-page writes",
        "read the sudohulk.com note on pd_lsn and record LSN as markdown",
        "what is Vignesh Kumar A working on and reading now",
        "list the tracks followed in public on sudohulk.com"
      ]
    },
    {
      "identifier": "urn:air:sudohulk.com:agent:librarian",
      "displayName": "sudohulk.com librarian (A2A)",
      "description": "A read-only A2A agent with no model behind it: send it words and it searches the site, send it a path and it returns the page as markdown, send \"tracks\" and it lists the tracks.",
      "type": "application/a2a-agent-card+json",
      "url": "https://sudohulk.com/.well-known/agent-card.json",
      "tags": [
        "a2a",
        "agents",
        "postgresql",
        "databases"
      ],
      "representativeQueries": [
        "ask the sudohulk.com agent about the write-ahead log",
        "which A2A agent can search sudohulk.com",
        "read a sudohulk.com page as markdown over A2A"
      ]
    },
    {
      "identifier": "urn:air:sudohulk.com:skill:postgres-wal-reading",
      "displayName": "postgres-wal-reading",
      "description": "Read PostgreSQL's write-ahead log on a running server or from a pg_wal directory. Turn an LSN into a WAL file name and offset, measure how much WAL a workload wrote, list and summarise records with pg_walinspect and pg_waldump, and explain full-page images, the page LSN (pd_lsn) and why redo skips a record. Use when a task involves an LSN, a WAL segment file, pg_waldump output, WAL volume or full-page writes. Distilled from the PostgreSQL 18 documentation and source.",
      "type": "application/ai-skill+md",
      "url": "https://sudohulk.com/.well-known/agent-skills/postgres-wal-reading/SKILL.md",
      "tags": [
        "agent-skills",
        "postgresql",
        "wal",
        "databases"
      ],
      "representativeQueries": [
        "which PostgreSQL WAL file holds this LSN",
        "how much WAL did this PostgreSQL workload write",
        "read pg_waldump output",
        "why does PostgreSQL write full-page images after a checkpoint"
      ]
    },
    {
      "identifier": "urn:air:sudohulk.com:skill:read-and-cite-sudohulk",
      "displayName": "read-and-cite-sudohulk",
      "description": "Read sudohulk.com, Vignesh Kumar A's site on computer science (databases first), as clean markdown instead of HTML, find pages through llms.txt and content.json, and quote and cite it correctly under CC BY 4.0. Use when a task involves reading, summarising or quoting anything published on sudohulk.com.",
      "type": "application/ai-skill+md",
      "url": "https://sudohulk.com/.well-known/agent-skills/read-and-cite-sudohulk/SKILL.md",
      "tags": [
        "agent-skills",
        "citation",
        "markdown",
        "llms.txt"
      ],
      "representativeQueries": [
        "how do I cite a page from sudohulk.com",
        "how do I read sudohulk.com pages as markdown",
        "find every post and note on sudohulk.com",
        "how should an AI agent send feedback on a sudohulk.com post"
      ]
    },
    {
      "identifier": "urn:air:sudohulk.com:skill:sudohulk-mcp",
      "displayName": "sudohulk-mcp",
      "description": "Connect to the public MCP server at https://sudohulk.com/mcp and use its tools to search, list and read Vignesh Kumar A's essays, notes, updates, projects, streams and tracks as markdown. Covers connecting, the protocol versions it speaks, each tool's arguments and results, its resources and its errors. Use when an agent with MCP needs content from sudohulk.com.",
      "type": "application/ai-skill+md",
      "url": "https://sudohulk.com/.well-known/agent-skills/sudohulk-mcp/SKILL.md",
      "tags": [
        "agent-skills",
        "mcp",
        "tools"
      ],
      "representativeQueries": [
        "how do I connect to the sudohulk.com MCP server",
        "which tools does the sudohulk.com MCP server offer",
        "search sudohulk.com from an MCP client"
      ]
    },
    {
      "identifier": "urn:air:sudohulk.com:api:catalog",
      "displayName": "sudohulk.com API catalog",
      "description": "The site's public HTTP APIs (RFC 9727), each with its OpenAPI description and documentation.",
      "type": "application/linkset+json",
      "url": "https://sudohulk.com/.well-known/api-catalog",
      "tags": [
        "api-catalog",
        "openapi"
      ],
      "representativeQueries": [
        "what APIs does sudohulk.com offer",
        "where is the OpenAPI description for sudohulk.com",
        "how do I send a correction on a sudohulk.com post"
      ]
    }
  ]
}