styleguide.fyi

{
  "name": "list-sections",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the 12 sections of A Common Coding Style Guide, each with its id, title, summary and rule titles. Call this first to find the section that covers a topic, then call get-section with its id.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "get-section",
  "kind": "act",
  "impl": "imperative",
  "description": "Get every rule in one section of the style guide as markdown, with the rationale and the avoid/prefer code examples. Use it to review or write code in one area, such as naming, errors or tests. It also scrolls the page to the section.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "section": {
        "type": "string",
        "enum": [
          "read-first",
          "scope",
          "naming",
          "functions",
          "types-and-data",
          "errors",
          "concurrency",
          "comments",
          "tests",
          "structure",
          "commits",
          "agents"
        ],
        "description": "Section id, as returned by list-sections."
      }
    },
    "required": [
      "section"
    ]
  },
  "page": "/"
}

{
  "name": "search-rules",
  "kind": "act",
  "impl": "imperative",
  "description": "Find style guide rules by keyword, for example \"error handling\", \"boolean names\" or \"mocks\". Returns up to 10 rules that contain every word, best match first, each with its id, URL and full markdown. It also filters the visible page to the matches.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "One or more keywords. A rule must contain all of them."
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/"
}

{
  "name": "get-styleguide",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get the complete style guide (59 rules) as one markdown document. Use it to save the guide as AGENTS.md or CLAUDE.md, or to follow it as coding instructions for the rest of a session.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "exec",
  "kind": "answer",
  "impl": "imperative",
  "description": "Run Bash commands over a read-only, in-memory copy of this coding style guide. Each call starts at /guide. Start with `ls /guide` or `cat /guide/README.md`. Read the whole guide at /guide/styleguide.md, sections at /guide/sections/<id>.md, individual rules at /guide/rules/<id>.md, and paths/titles/URLs in /guide/index.json. Read reviewer ratings and rationales at /guide/consensus.json; null means not rated. Use ls, cat, find, tree, grep, rg, head, tail, wc, sort, uniq, cut, tr, sed, awk, jq and pipes. No writes, network or external programs. No state persists between calls. Returns {stdout, stderr, exitCode}; a nonzero exitCode indicates a command error. Commands are limited to 4096 characters, execution to 3 seconds and output to 64 KiB, counted across every command in a pipeline. Narrow large queries with head or more specific paths.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "command": {
        "type": "string",
        "minLength": 1,
        "maxLength": 4096,
        "description": "Bash command, for example: cat sections/errors.md | head -30"
      }
    },
    "required": [
      "command"
    ],
    "additionalProperties": false
  },
  "page": "/"
}