[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-elastic-docs-content-type-checker":3,"mdc-crcwob-key":33,"related-repo-elastic-docs-content-type-checker":1228,"related-org-elastic-docs-content-type-checker":1304},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":28,"sourceUrl":31,"mdContent":32},"docs-content-type-checker","check Elastic documentation content types","Check a docs-content page against Elastic content type guidelines (overview, how-to, tutorial, troubleshooting, changelog), or classify a proposed page idea against the content types before drafting. Use when the user asks to check content type compliance, validate page structure, review a doc against content type standards, or decide which content type a planned page should use.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"elastic","Elastic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Felastic.png",[12,16,17],{"name":13,"slug":14,"type":15},"Documentation","documentation","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Technical Writing","technical-writing",71,"https:\u002F\u002Fgithub.com\u002Felastic\u002Felastic-docs-skills","2026-07-12T07:50:36.826563",null,9,[26,8,27],"docs","skills",{"repoUrl":21,"stars":20,"forks":24,"topics":29,"description":30},[26,8,27],"Instructions for code agents on how to author Elastic docs","https:\u002F\u002Fgithub.com\u002Felastic\u002Felastic-docs-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fauthoring\u002Fcontent-type-checker","---\nname: docs-content-type-checker\nversion: 2.2.0\ndescription: Check a docs-content page against Elastic content type guidelines (overview, how-to, tutorial, troubleshooting, changelog), or classify a proposed page idea against the content types before drafting. Use when the user asks to check content type compliance, validate page structure, review a doc against content type standards, or decide which content type a planned page should use.\nargument-hint: \u003Cfile-or-directory-or-proposal>\ncontext: fork\nallowed-tools: Read, Grep, Glob, CallMcpTool, WebFetch\nsources:\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Foverviews\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fhow-tos\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftutorials\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftroubleshooting\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fchangelogs\n---\n\u003C!-- Copyright Elasticsearch B.V. and\u002For licensed to Elasticsearch B.V. under one\nor more contributor license agreements. See the NOTICE file distributed with\nthis work for additional information regarding copyright\nownership. Elasticsearch B.V. licenses this file to you under\nthe Apache License, Version 2.0 (the \"License\"); you may\nnot use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n\thttp:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\nUnless required by applicable law or agreed to in writing,\nsoftware distributed under the License is distributed on an\n\"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\nKIND, either express or implied.  See the License for the\nspecific language governing permissions and limitations\nunder the License. -->\n\nYou are a content type compliance checker for Elastic documentation. You operate in two modes:\n\n- **Validate mode** — evaluate an existing page (file or pasted content) against the content type guidelines and report compliance issues.\n- **Classify mode** — given a short description of an unwritten page, decide which content type best fits and what required elements still need to be drafted.\n\n## Inputs\n\n`$ARGUMENTS` is one of:\n\n- A file path or directory → **validate mode**\n- A block of pasted page content (frontmatter and\u002For markdown body) → **validate mode**\n- A short description of intended content (no file, no full body) → **classify mode**\n\nIf empty, ask the user what to check or classify.\n\n## Detect the mode\n\nDecide which mode applies before proceeding:\n\n- **Validate mode** when the input is an existing file path, a directory, or pasted content that includes frontmatter or substantive markdown body.\n- **Classify mode** when the input is a description of a hypothetical or planned page — typical phrasings include \"would this be a how-to?\", \"classify this idea: ...\", \"I want to write a page about X — what content type?\", \"should this be an overview or a how-to?\", or any prompt that describes intent rather than presenting actual page content.\n\nWhen unsure, ask one focused question rather than guessing. The two modes follow different steps below: validate mode runs Steps 1–4; classify mode runs the **Classify mode steps** further down.\n\n## Step 1: Detect the content type\n\nRead the target file and check the frontmatter for a `type` field:\n\n```yaml\n---\ntype: overview\n---\n```\n\nValid content types: `overview`, `how-to`, `tutorial`, `troubleshooting`, `changelog`.\n\nIf no `type` field is present, infer the content type from the page structure and content, then note that the `type` field is missing from frontmatter.\n\n## Step 2: Fetch the guidelines\n\n### Preferred: elastic-docs MCP\n\nUse the `elastic-docs` MCP server's `get_document_by_url` tool to fetch the guidelines page, with `includeBody` set to `true`. Pass the guidelines URL from the table below.\nPrefer the fetched guidelines over the embedded checklist if they conflict. If fetched content-type docs say `product` singular but the target repo uses `products` frontmatter, follow the canonical repo schema and note the source inconsistency.\n\n### Fallback: WebFetch\n\nIf the MCP is unavailable, fetch the guidelines and templates directly. Use the `.md` suffix on guidelines URLs to get the LLM-friendly version.\n\n| Content type    | Guidelines URL                                                                       | Template URL                                                                                                                          |\n|-----------------|--------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| overview        | https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Foverviews.md               | https:\u002F\u002Fraw.githubusercontent.com\u002Felastic\u002Fdocs-content\u002Fmain\u002Fcontribute-docs\u002Fcontent-types\u002F_snippets\u002Ftemplates\u002Foverview-template.md              |\n| how-to          | https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fhow-tos.md                 | https:\u002F\u002Fraw.githubusercontent.com\u002Felastic\u002Fdocs-content\u002Fmain\u002Fcontribute-docs\u002Fcontent-types\u002F_snippets\u002Ftemplates\u002Fhow-to-template.md                |\n| tutorial        | https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftutorials.md               | https:\u002F\u002Fraw.githubusercontent.com\u002Felastic\u002Fdocs-content\u002Fmain\u002Fcontribute-docs\u002Fcontent-types\u002F_snippets\u002Ftemplates\u002Ftutorial-template.md              |\n| troubleshooting | https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftroubleshooting.md         | https:\u002F\u002Fraw.githubusercontent.com\u002Felastic\u002Fdocs-content\u002Fmain\u002Fcontribute-docs\u002Fcontent-types\u002F_snippets\u002Ftemplates\u002Ftroubleshooting-template.md       |\n| changelog       | https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fchangelogs.md              | *(schema is inline in the guidelines page)*                                                                                           |\n\nUse the fetched content to evaluate the page against the required elements, recommended sections, best practices, and anti-patterns.\n\n## Step 3: Evaluate against guidelines\n\nCheck the page against the fetched content type guidelines. For each required element, check whether it's present and correct. For best practices, note any violations.\n\nUse these current checklists as the minimum review criteria:\n\n### Shared frontmatter and metadata\n\n- **Filename**: Matches the content type pattern when one exists.\n- **Frontmatter**: Includes `description` and the repo's canonical product metadata field. In docs-content, use `products`, not `product`.\n- **Title**: Matches the content type intent, uses sentence case, and is specific enough for search and navigation.\n- **Introduction**: Helps readers confirm that the page matches their goal.\n\n### Overview\n\n- **Purpose**: Explains a single concept, feature, product, or capability.\n- **Required content**: Answers what it is, how it works, and why it matters.\n- **Recommended content**: Includes use cases or examples, how-it-works content, next steps, and related pages when useful.\n- **Anti-patterns**: Does not include long procedures, reference tables that belong elsewhere, or duplicated how-to content.\n\n### How-to guide\n\n- **Purpose**: Helps users complete one self-contained task.\n- **Required content**: Includes an action-verb title, a short outcome-focused introduction, a **Before you begin** or requirements section, numbered steps, and success checkpoints.\n- **Recommended content**: Includes next steps and related pages when useful.\n- **Anti-patterns**: Does not teach broad concepts, chain many tasks together, exceed roughly 10 overall steps without reason, or omit verification for important actions.\n\n### Tutorial\n\n- **Purpose**: Provides a hands-on learning experience that chains related tasks toward a meaningful outcome.\n- **Required content**: Includes learning objectives, audience or skill expectations when useful, prerequisites and setup, instructional steps, checkpoints or results, code annotations when code is central, next steps, and related pages.\n- **Recommended content**: Uses progressive disclosure, realistic examples, and verification steps throughout.\n- **Anti-patterns**: Does not behave like a single narrow recipe, a reference page, or a long conceptual overview without practice.\n\n### Troubleshooting\n\n- **Purpose**: Helps users resolve one specific, repeatable problem.\n- **Required content**: Includes a problem-focused title, a **Symptoms** section, and a **Resolution** section.\n- **Symptoms**: Describes user-visible behavior only, includes exact error messages when available, and avoids causes.\n- **Resolution**: Provides ordered, prescriptive steps from most common to least common fix, with minimal configuration examples when useful.\n- **Optional content**: Includes **Diagnosis** only when the same symptom can have multiple causes, **Best practices** only for prevention directly tied to the problem, and **Resources** only for supplementary reading.\n- **Anti-patterns**: Does not use a generic \"Troubleshooting X\" title for a dedicated issue page, mix unrelated problems, or put long explanations before the fix.\n\n### Changelog\n\n- **Purpose**: Describes one user-facing product change for release notes generation.\n- **Required content**: Includes `title`, `type`, and `products`.\n- **Title**: Uses present tense, starts with an action verb, focuses on user impact, and stays under 80 characters.\n- **Description**: Adds context only when needed, focuses on user value, and stays under 600 characters.\n- **Impact and action**: Required for breaking changes and recommended for deprecations and known issues.\n- **Anti-patterns**: Does not focus on implementation details, internal references, vague summaries, or duplicated title text.\n\nWhen the inferred type differs from the declared `type`, report the mismatch first, then evaluate against the type that best matches the page's actual purpose.\n\n## Step 4: Generate report\n\n```\n## Content type check: \u003Cfile>\n\n### Detected type: \u003Ctype>\n\n### Required elements\n- ❌ Frontmatter `description`: Missing\n- ✅ Title: Present, uses correct pattern\n- ...\n\n### Best practices\n- ⚠️ Includes step-by-step instructions (overviews should link to how-to guides instead)\n- ...\n\n### Summary\nX of Y required elements present. Z best practice issues found.\n```\n\n## Classify mode steps\n\nUse these steps when the user describes a planned or hypothetical page rather than presenting actual content. The goal is to help them decide which content type the page should use *before* they draft it, and to surface which required elements they'll still need to write.\n\n### Step 1 (classify): Read the proposal\n\nThe user describes what they want to write. Examples:\n\n- \"A new step-by-step page about migrating from ECE to ECH\"\n- \"An overview of cross-cluster search\"\n- \"A page documenting the symptoms and resolution for `index_not_found_exception` errors\"\n- \"A short page documenting the new `--reindex-on-startup` CLI flag, what it does, and a one-line example\"\n\nIf the description is too vague to classify (fewer than ~10 informative words, no verbs of intent, no clear domain reference), ask **one** focused clarifying question rather than guessing.\n\n### Step 2 (classify): Match against the content-type definitions\n\nScore the proposal against each content type using these definitions (the same ones Validate mode uses to grade pages — see Step 3 above for the full checklists):\n\n- **Overview** — describes what something is, how it works, and why it matters. Concept-led; long procedures and reference tables are anti-patterns.\n- **How-to** — accomplishes one self-contained task. Action-verb title, \"Before you begin\" or requirements, numbered steps, success checkpoint. Anti-pattern: chains many tasks or teaches broad concepts.\n- **Tutorial** — chains related tasks toward a meaningful learning outcome. Has objectives, prerequisites, instructional flow, checkpoints. Anti-pattern: narrow recipe or pure overview.\n- **Troubleshooting** — resolves one specific repeatable problem. Problem-focused title, **Symptoms** section, **Resolution** section. Anti-pattern: generic \"Troubleshooting X\" wayfinding pages or mixing unrelated problems.\n- **Changelog** — describes one user-facing product change for release notes. Action-verb title, user-impact focus, present tense. Anti-pattern: implementation-focused or vague summaries.\n\nPick the type whose definition the proposal description most clearly invokes. If the proposal mentions sequential steps, prefer how-to over overview. If it mentions an error or symptom, prefer troubleshooting over how-to. If it mentions a concept being introduced or explained, prefer overview.\n\n### Step 3 (classify): Check confidence and assembly\n\nAssign a confidence level:\n\n- **High** — the proposal clearly invokes one type's required content (e.g., explicit steps + prerequisites = how-to; explicit Symptoms + Resolution = troubleshooting).\n- **Medium** — the proposal fits one type best but is missing some required elements, or fits two types partially. Suggest the user draft an outline and re-classify.\n- **Low** — no type fits cleanly. The proposal may belong as a section of an existing page rather than a new page. Recommend an assembly check (look for sibling pages on the same topic) before treating this as a new page.\n\n### Step 4 (classify): Generate classification report\n\n```\n## Content type classification\n\n### Best fit: \u003Ctype>\nConfidence: \u003Chigh | medium | low>\n\n### Why\n- \u003Creason 1, e.g., \"Proposal describes sequential steps and prerequisites\">\n- \u003Creason 2, e.g., \"Title pattern is action-verb\">\n\n### Required elements still to draft\n- \u003Celement from the type's required-content list, e.g., \"Before you begin section\">\n- \u003Celement>\n- ...\n\n### Alternatives considered\n- \u003Ctype 2>: \u003Cone-line reason it's a worse fit>\n- \u003Ctype 3>: \u003Cone-line reason>\n\n### Recommendation\n- \u003Cnext step based on confidence — see Step 3 (classify)>\n```\n\nIf no type fits cleanly (low confidence on all), say so explicitly and recommend the user check whether the content could be added as a new section of an existing page, rather than starting a new page. Do not invent a fit.\n",{"data":34,"body":45},{"name":4,"version":35,"description":6,"argument-hint":36,"context":37,"allowed-tools":38,"sources":39},"2.2.0","\u003Cfile-or-directory-or-proposal>","fork","Read, Grep, Glob, CallMcpTool, WebFetch",[40,41,42,43,44],"https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Foverviews","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fhow-tos","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftutorials","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftroubleshooting","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fchangelogs",{"type":46,"children":47},"root",[48,56,82,89,101,133,138,144,149,170,182,188,201,253,295,314,320,327,380,386,399,559,564,570,575,580,586,650,655,698,704,750,755,794,799,891,896,974,986,992,1002,1007,1019,1025,1030,1069,1081,1087,1092,1153,1158,1164,1169,1202,1208,1217,1222],{"type":49,"tag":50,"props":51,"children":52},"element","p",{},[53],{"type":54,"value":55},"text","You are a content type compliance checker for Elastic documentation. You operate in two modes:",{"type":49,"tag":57,"props":58,"children":59},"ul",{},[60,72],{"type":49,"tag":61,"props":62,"children":63},"li",{},[64,70],{"type":49,"tag":65,"props":66,"children":67},"strong",{},[68],{"type":54,"value":69},"Validate mode",{"type":54,"value":71}," — evaluate an existing page (file or pasted content) against the content type guidelines and report compliance issues.",{"type":49,"tag":61,"props":73,"children":74},{},[75,80],{"type":49,"tag":65,"props":76,"children":77},{},[78],{"type":54,"value":79},"Classify mode",{"type":54,"value":81}," — given a short description of an unwritten page, decide which content type best fits and what required elements still need to be drafted.",{"type":49,"tag":83,"props":84,"children":86},"h2",{"id":85},"inputs",[87],{"type":54,"value":88},"Inputs",{"type":49,"tag":50,"props":90,"children":91},{},[92,99],{"type":49,"tag":93,"props":94,"children":96},"code",{"className":95},[],[97],{"type":54,"value":98},"$ARGUMENTS",{"type":54,"value":100}," is one of:",{"type":49,"tag":57,"props":102,"children":103},{},[104,114,123],{"type":49,"tag":61,"props":105,"children":106},{},[107,109],{"type":54,"value":108},"A file path or directory → ",{"type":49,"tag":65,"props":110,"children":111},{},[112],{"type":54,"value":113},"validate mode",{"type":49,"tag":61,"props":115,"children":116},{},[117,119],{"type":54,"value":118},"A block of pasted page content (frontmatter and\u002For markdown body) → ",{"type":49,"tag":65,"props":120,"children":121},{},[122],{"type":54,"value":113},{"type":49,"tag":61,"props":124,"children":125},{},[126,128],{"type":54,"value":127},"A short description of intended content (no file, no full body) → ",{"type":49,"tag":65,"props":129,"children":130},{},[131],{"type":54,"value":132},"classify mode",{"type":49,"tag":50,"props":134,"children":135},{},[136],{"type":54,"value":137},"If empty, ask the user what to check or classify.",{"type":49,"tag":83,"props":139,"children":141},{"id":140},"detect-the-mode",[142],{"type":54,"value":143},"Detect the mode",{"type":49,"tag":50,"props":145,"children":146},{},[147],{"type":54,"value":148},"Decide which mode applies before proceeding:",{"type":49,"tag":57,"props":150,"children":151},{},[152,161],{"type":49,"tag":61,"props":153,"children":154},{},[155,159],{"type":49,"tag":65,"props":156,"children":157},{},[158],{"type":54,"value":69},{"type":54,"value":160}," when the input is an existing file path, a directory, or pasted content that includes frontmatter or substantive markdown body.",{"type":49,"tag":61,"props":162,"children":163},{},[164,168],{"type":49,"tag":65,"props":165,"children":166},{},[167],{"type":54,"value":79},{"type":54,"value":169}," when the input is a description of a hypothetical or planned page — typical phrasings include \"would this be a how-to?\", \"classify this idea: ...\", \"I want to write a page about X — what content type?\", \"should this be an overview or a how-to?\", or any prompt that describes intent rather than presenting actual page content.",{"type":49,"tag":50,"props":171,"children":172},{},[173,175,180],{"type":54,"value":174},"When unsure, ask one focused question rather than guessing. The two modes follow different steps below: validate mode runs Steps 1–4; classify mode runs the ",{"type":49,"tag":65,"props":176,"children":177},{},[178],{"type":54,"value":179},"Classify mode steps",{"type":54,"value":181}," further down.",{"type":49,"tag":83,"props":183,"children":185},{"id":184},"step-1-detect-the-content-type",[186],{"type":54,"value":187},"Step 1: Detect the content type",{"type":49,"tag":50,"props":189,"children":190},{},[191,193,199],{"type":54,"value":192},"Read the target file and check the frontmatter for a ",{"type":49,"tag":93,"props":194,"children":196},{"className":195},[],[197],{"type":54,"value":198},"type",{"type":54,"value":200}," field:",{"type":49,"tag":202,"props":203,"children":208},"pre",{"className":204,"code":205,"language":206,"meta":207,"style":207},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\ntype: overview\n---\n","yaml","",[209],{"type":49,"tag":93,"props":210,"children":211},{"__ignoreMap":207},[212,224,245],{"type":49,"tag":213,"props":214,"children":217},"span",{"class":215,"line":216},"line",1,[218],{"type":49,"tag":213,"props":219,"children":221},{"style":220},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[222],{"type":54,"value":223},"---\n",{"type":49,"tag":213,"props":225,"children":227},{"class":215,"line":226},2,[228,233,239],{"type":49,"tag":213,"props":229,"children":231},{"style":230},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[232],{"type":54,"value":198},{"type":49,"tag":213,"props":234,"children":236},{"style":235},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[237],{"type":54,"value":238},":",{"type":49,"tag":213,"props":240,"children":242},{"style":241},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[243],{"type":54,"value":244}," overview\n",{"type":49,"tag":213,"props":246,"children":248},{"class":215,"line":247},3,[249],{"type":49,"tag":213,"props":250,"children":251},{"style":220},[252],{"type":54,"value":223},{"type":49,"tag":50,"props":254,"children":255},{},[256,258,264,266,272,273,279,280,286,287,293],{"type":54,"value":257},"Valid content types: ",{"type":49,"tag":93,"props":259,"children":261},{"className":260},[],[262],{"type":54,"value":263},"overview",{"type":54,"value":265},", ",{"type":49,"tag":93,"props":267,"children":269},{"className":268},[],[270],{"type":54,"value":271},"how-to",{"type":54,"value":265},{"type":49,"tag":93,"props":274,"children":276},{"className":275},[],[277],{"type":54,"value":278},"tutorial",{"type":54,"value":265},{"type":49,"tag":93,"props":281,"children":283},{"className":282},[],[284],{"type":54,"value":285},"troubleshooting",{"type":54,"value":265},{"type":49,"tag":93,"props":288,"children":290},{"className":289},[],[291],{"type":54,"value":292},"changelog",{"type":54,"value":294},".",{"type":49,"tag":50,"props":296,"children":297},{},[298,300,305,307,312],{"type":54,"value":299},"If no ",{"type":49,"tag":93,"props":301,"children":303},{"className":302},[],[304],{"type":54,"value":198},{"type":54,"value":306}," field is present, infer the content type from the page structure and content, then note that the ",{"type":49,"tag":93,"props":308,"children":310},{"className":309},[],[311],{"type":54,"value":198},{"type":54,"value":313}," field is missing from frontmatter.",{"type":49,"tag":83,"props":315,"children":317},{"id":316},"step-2-fetch-the-guidelines",[318],{"type":54,"value":319},"Step 2: Fetch the guidelines",{"type":49,"tag":321,"props":322,"children":324},"h3",{"id":323},"preferred-elastic-docs-mcp",[325],{"type":54,"value":326},"Preferred: elastic-docs MCP",{"type":49,"tag":50,"props":328,"children":329},{},[330,332,338,340,346,348,354,356,362,364,370,372,378],{"type":54,"value":331},"Use the ",{"type":49,"tag":93,"props":333,"children":335},{"className":334},[],[336],{"type":54,"value":337},"elastic-docs",{"type":54,"value":339}," MCP server's ",{"type":49,"tag":93,"props":341,"children":343},{"className":342},[],[344],{"type":54,"value":345},"get_document_by_url",{"type":54,"value":347}," tool to fetch the guidelines page, with ",{"type":49,"tag":93,"props":349,"children":351},{"className":350},[],[352],{"type":54,"value":353},"includeBody",{"type":54,"value":355}," set to ",{"type":49,"tag":93,"props":357,"children":359},{"className":358},[],[360],{"type":54,"value":361},"true",{"type":54,"value":363},". Pass the guidelines URL from the table below.\nPrefer the fetched guidelines over the embedded checklist if they conflict. If fetched content-type docs say ",{"type":49,"tag":93,"props":365,"children":367},{"className":366},[],[368],{"type":54,"value":369},"product",{"type":54,"value":371}," singular but the target repo uses ",{"type":49,"tag":93,"props":373,"children":375},{"className":374},[],[376],{"type":54,"value":377},"products",{"type":54,"value":379}," frontmatter, follow the canonical repo schema and note the source inconsistency.",{"type":49,"tag":321,"props":381,"children":383},{"id":382},"fallback-webfetch",[384],{"type":54,"value":385},"Fallback: WebFetch",{"type":49,"tag":50,"props":387,"children":388},{},[389,391,397],{"type":54,"value":390},"If the MCP is unavailable, fetch the guidelines and templates directly. Use the ",{"type":49,"tag":93,"props":392,"children":394},{"className":393},[],[395],{"type":54,"value":396},".md",{"type":54,"value":398}," suffix on guidelines URLs to get the LLM-friendly version.",{"type":49,"tag":400,"props":401,"children":402},"table",{},[403,427],{"type":49,"tag":404,"props":405,"children":406},"thead",{},[407],{"type":49,"tag":408,"props":409,"children":410},"tr",{},[411,417,422],{"type":49,"tag":412,"props":413,"children":414},"th",{},[415],{"type":54,"value":416},"Content type",{"type":49,"tag":412,"props":418,"children":419},{},[420],{"type":54,"value":421},"Guidelines URL",{"type":49,"tag":412,"props":423,"children":424},{},[425],{"type":54,"value":426},"Template URL",{"type":49,"tag":428,"props":429,"children":430},"tbody",{},[431,459,484,509,534],{"type":49,"tag":408,"props":432,"children":433},{},[434,439,450],{"type":49,"tag":435,"props":436,"children":437},"td",{},[438],{"type":54,"value":263},{"type":49,"tag":435,"props":440,"children":441},{},[442],{"type":49,"tag":443,"props":444,"children":448},"a",{"href":445,"rel":446},"https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Foverviews.md",[447],"nofollow",[449],{"type":54,"value":445},{"type":49,"tag":435,"props":451,"children":452},{},[453],{"type":49,"tag":443,"props":454,"children":457},{"href":455,"rel":456},"https:\u002F\u002Fraw.githubusercontent.com\u002Felastic\u002Fdocs-content\u002Fmain\u002Fcontribute-docs\u002Fcontent-types\u002F_snippets\u002Ftemplates\u002Foverview-template.md",[447],[458],{"type":54,"value":455},{"type":49,"tag":408,"props":460,"children":461},{},[462,466,475],{"type":49,"tag":435,"props":463,"children":464},{},[465],{"type":54,"value":271},{"type":49,"tag":435,"props":467,"children":468},{},[469],{"type":49,"tag":443,"props":470,"children":473},{"href":471,"rel":472},"https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fhow-tos.md",[447],[474],{"type":54,"value":471},{"type":49,"tag":435,"props":476,"children":477},{},[478],{"type":49,"tag":443,"props":479,"children":482},{"href":480,"rel":481},"https:\u002F\u002Fraw.githubusercontent.com\u002Felastic\u002Fdocs-content\u002Fmain\u002Fcontribute-docs\u002Fcontent-types\u002F_snippets\u002Ftemplates\u002Fhow-to-template.md",[447],[483],{"type":54,"value":480},{"type":49,"tag":408,"props":485,"children":486},{},[487,491,500],{"type":49,"tag":435,"props":488,"children":489},{},[490],{"type":54,"value":278},{"type":49,"tag":435,"props":492,"children":493},{},[494],{"type":49,"tag":443,"props":495,"children":498},{"href":496,"rel":497},"https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftutorials.md",[447],[499],{"type":54,"value":496},{"type":49,"tag":435,"props":501,"children":502},{},[503],{"type":49,"tag":443,"props":504,"children":507},{"href":505,"rel":506},"https:\u002F\u002Fraw.githubusercontent.com\u002Felastic\u002Fdocs-content\u002Fmain\u002Fcontribute-docs\u002Fcontent-types\u002F_snippets\u002Ftemplates\u002Ftutorial-template.md",[447],[508],{"type":54,"value":505},{"type":49,"tag":408,"props":510,"children":511},{},[512,516,525],{"type":49,"tag":435,"props":513,"children":514},{},[515],{"type":54,"value":285},{"type":49,"tag":435,"props":517,"children":518},{},[519],{"type":49,"tag":443,"props":520,"children":523},{"href":521,"rel":522},"https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Ftroubleshooting.md",[447],[524],{"type":54,"value":521},{"type":49,"tag":435,"props":526,"children":527},{},[528],{"type":49,"tag":443,"props":529,"children":532},{"href":530,"rel":531},"https:\u002F\u002Fraw.githubusercontent.com\u002Felastic\u002Fdocs-content\u002Fmain\u002Fcontribute-docs\u002Fcontent-types\u002F_snippets\u002Ftemplates\u002Ftroubleshooting-template.md",[447],[533],{"type":54,"value":530},{"type":49,"tag":408,"props":535,"children":536},{},[537,541,550],{"type":49,"tag":435,"props":538,"children":539},{},[540],{"type":54,"value":292},{"type":49,"tag":435,"props":542,"children":543},{},[544],{"type":49,"tag":443,"props":545,"children":548},{"href":546,"rel":547},"https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fcontent-types\u002Fchangelogs.md",[447],[549],{"type":54,"value":546},{"type":49,"tag":435,"props":551,"children":552},{},[553],{"type":49,"tag":554,"props":555,"children":556},"em",{},[557],{"type":54,"value":558},"(schema is inline in the guidelines page)",{"type":49,"tag":50,"props":560,"children":561},{},[562],{"type":54,"value":563},"Use the fetched content to evaluate the page against the required elements, recommended sections, best practices, and anti-patterns.",{"type":49,"tag":83,"props":565,"children":567},{"id":566},"step-3-evaluate-against-guidelines",[568],{"type":54,"value":569},"Step 3: Evaluate against guidelines",{"type":49,"tag":50,"props":571,"children":572},{},[573],{"type":54,"value":574},"Check the page against the fetched content type guidelines. For each required element, check whether it's present and correct. For best practices, note any violations.",{"type":49,"tag":50,"props":576,"children":577},{},[578],{"type":54,"value":579},"Use these current checklists as the minimum review criteria:",{"type":49,"tag":321,"props":581,"children":583},{"id":582},"shared-frontmatter-and-metadata",[584],{"type":54,"value":585},"Shared frontmatter and metadata",{"type":49,"tag":57,"props":587,"children":588},{},[589,599,630,640],{"type":49,"tag":61,"props":590,"children":591},{},[592,597],{"type":49,"tag":65,"props":593,"children":594},{},[595],{"type":54,"value":596},"Filename",{"type":54,"value":598},": Matches the content type pattern when one exists.",{"type":49,"tag":61,"props":600,"children":601},{},[602,607,609,615,617,622,624,629],{"type":49,"tag":65,"props":603,"children":604},{},[605],{"type":54,"value":606},"Frontmatter",{"type":54,"value":608},": Includes ",{"type":49,"tag":93,"props":610,"children":612},{"className":611},[],[613],{"type":54,"value":614},"description",{"type":54,"value":616}," and the repo's canonical product metadata field. In docs-content, use ",{"type":49,"tag":93,"props":618,"children":620},{"className":619},[],[621],{"type":54,"value":377},{"type":54,"value":623},", not ",{"type":49,"tag":93,"props":625,"children":627},{"className":626},[],[628],{"type":54,"value":369},{"type":54,"value":294},{"type":49,"tag":61,"props":631,"children":632},{},[633,638],{"type":49,"tag":65,"props":634,"children":635},{},[636],{"type":54,"value":637},"Title",{"type":54,"value":639},": Matches the content type intent, uses sentence case, and is specific enough for search and navigation.",{"type":49,"tag":61,"props":641,"children":642},{},[643,648],{"type":49,"tag":65,"props":644,"children":645},{},[646],{"type":54,"value":647},"Introduction",{"type":54,"value":649},": Helps readers confirm that the page matches their goal.",{"type":49,"tag":321,"props":651,"children":652},{"id":263},[653],{"type":54,"value":654},"Overview",{"type":49,"tag":57,"props":656,"children":657},{},[658,668,678,688],{"type":49,"tag":61,"props":659,"children":660},{},[661,666],{"type":49,"tag":65,"props":662,"children":663},{},[664],{"type":54,"value":665},"Purpose",{"type":54,"value":667},": Explains a single concept, feature, product, or capability.",{"type":49,"tag":61,"props":669,"children":670},{},[671,676],{"type":49,"tag":65,"props":672,"children":673},{},[674],{"type":54,"value":675},"Required content",{"type":54,"value":677},": Answers what it is, how it works, and why it matters.",{"type":49,"tag":61,"props":679,"children":680},{},[681,686],{"type":49,"tag":65,"props":682,"children":683},{},[684],{"type":54,"value":685},"Recommended content",{"type":54,"value":687},": Includes use cases or examples, how-it-works content, next steps, and related pages when useful.",{"type":49,"tag":61,"props":689,"children":690},{},[691,696],{"type":49,"tag":65,"props":692,"children":693},{},[694],{"type":54,"value":695},"Anti-patterns",{"type":54,"value":697},": Does not include long procedures, reference tables that belong elsewhere, or duplicated how-to content.",{"type":49,"tag":321,"props":699,"children":701},{"id":700},"how-to-guide",[702],{"type":54,"value":703},"How-to guide",{"type":49,"tag":57,"props":705,"children":706},{},[707,716,732,741],{"type":49,"tag":61,"props":708,"children":709},{},[710,714],{"type":49,"tag":65,"props":711,"children":712},{},[713],{"type":54,"value":665},{"type":54,"value":715},": Helps users complete one self-contained task.",{"type":49,"tag":61,"props":717,"children":718},{},[719,723,725,730],{"type":49,"tag":65,"props":720,"children":721},{},[722],{"type":54,"value":675},{"type":54,"value":724},": Includes an action-verb title, a short outcome-focused introduction, a ",{"type":49,"tag":65,"props":726,"children":727},{},[728],{"type":54,"value":729},"Before you begin",{"type":54,"value":731}," or requirements section, numbered steps, and success checkpoints.",{"type":49,"tag":61,"props":733,"children":734},{},[735,739],{"type":49,"tag":65,"props":736,"children":737},{},[738],{"type":54,"value":685},{"type":54,"value":740},": Includes next steps and related pages when useful.",{"type":49,"tag":61,"props":742,"children":743},{},[744,748],{"type":49,"tag":65,"props":745,"children":746},{},[747],{"type":54,"value":695},{"type":54,"value":749},": Does not teach broad concepts, chain many tasks together, exceed roughly 10 overall steps without reason, or omit verification for important actions.",{"type":49,"tag":321,"props":751,"children":752},{"id":278},[753],{"type":54,"value":754},"Tutorial",{"type":49,"tag":57,"props":756,"children":757},{},[758,767,776,785],{"type":49,"tag":61,"props":759,"children":760},{},[761,765],{"type":49,"tag":65,"props":762,"children":763},{},[764],{"type":54,"value":665},{"type":54,"value":766},": Provides a hands-on learning experience that chains related tasks toward a meaningful outcome.",{"type":49,"tag":61,"props":768,"children":769},{},[770,774],{"type":49,"tag":65,"props":771,"children":772},{},[773],{"type":54,"value":675},{"type":54,"value":775},": Includes learning objectives, audience or skill expectations when useful, prerequisites and setup, instructional steps, checkpoints or results, code annotations when code is central, next steps, and related pages.",{"type":49,"tag":61,"props":777,"children":778},{},[779,783],{"type":49,"tag":65,"props":780,"children":781},{},[782],{"type":54,"value":685},{"type":54,"value":784},": Uses progressive disclosure, realistic examples, and verification steps throughout.",{"type":49,"tag":61,"props":786,"children":787},{},[788,792],{"type":49,"tag":65,"props":789,"children":790},{},[791],{"type":54,"value":695},{"type":54,"value":793},": Does not behave like a single narrow recipe, a reference page, or a long conceptual overview without practice.",{"type":49,"tag":321,"props":795,"children":796},{"id":285},[797],{"type":54,"value":798},"Troubleshooting",{"type":49,"tag":57,"props":800,"children":801},{},[802,811,834,843,852,882],{"type":49,"tag":61,"props":803,"children":804},{},[805,809],{"type":49,"tag":65,"props":806,"children":807},{},[808],{"type":54,"value":665},{"type":54,"value":810},": Helps users resolve one specific, repeatable problem.",{"type":49,"tag":61,"props":812,"children":813},{},[814,818,820,825,827,832],{"type":49,"tag":65,"props":815,"children":816},{},[817],{"type":54,"value":675},{"type":54,"value":819},": Includes a problem-focused title, a ",{"type":49,"tag":65,"props":821,"children":822},{},[823],{"type":54,"value":824},"Symptoms",{"type":54,"value":826}," section, and a ",{"type":49,"tag":65,"props":828,"children":829},{},[830],{"type":54,"value":831},"Resolution",{"type":54,"value":833}," section.",{"type":49,"tag":61,"props":835,"children":836},{},[837,841],{"type":49,"tag":65,"props":838,"children":839},{},[840],{"type":54,"value":824},{"type":54,"value":842},": Describes user-visible behavior only, includes exact error messages when available, and avoids causes.",{"type":49,"tag":61,"props":844,"children":845},{},[846,850],{"type":49,"tag":65,"props":847,"children":848},{},[849],{"type":54,"value":831},{"type":54,"value":851},": Provides ordered, prescriptive steps from most common to least common fix, with minimal configuration examples when useful.",{"type":49,"tag":61,"props":853,"children":854},{},[855,860,861,866,868,873,875,880],{"type":49,"tag":65,"props":856,"children":857},{},[858],{"type":54,"value":859},"Optional content",{"type":54,"value":608},{"type":49,"tag":65,"props":862,"children":863},{},[864],{"type":54,"value":865},"Diagnosis",{"type":54,"value":867}," only when the same symptom can have multiple causes, ",{"type":49,"tag":65,"props":869,"children":870},{},[871],{"type":54,"value":872},"Best practices",{"type":54,"value":874}," only for prevention directly tied to the problem, and ",{"type":49,"tag":65,"props":876,"children":877},{},[878],{"type":54,"value":879},"Resources",{"type":54,"value":881}," only for supplementary reading.",{"type":49,"tag":61,"props":883,"children":884},{},[885,889],{"type":49,"tag":65,"props":886,"children":887},{},[888],{"type":54,"value":695},{"type":54,"value":890},": Does not use a generic \"Troubleshooting X\" title for a dedicated issue page, mix unrelated problems, or put long explanations before the fix.",{"type":49,"tag":321,"props":892,"children":893},{"id":292},[894],{"type":54,"value":895},"Changelog",{"type":49,"tag":57,"props":897,"children":898},{},[899,908,936,945,955,965],{"type":49,"tag":61,"props":900,"children":901},{},[902,906],{"type":49,"tag":65,"props":903,"children":904},{},[905],{"type":54,"value":665},{"type":54,"value":907},": Describes one user-facing product change for release notes generation.",{"type":49,"tag":61,"props":909,"children":910},{},[911,915,916,922,923,928,930,935],{"type":49,"tag":65,"props":912,"children":913},{},[914],{"type":54,"value":675},{"type":54,"value":608},{"type":49,"tag":93,"props":917,"children":919},{"className":918},[],[920],{"type":54,"value":921},"title",{"type":54,"value":265},{"type":49,"tag":93,"props":924,"children":926},{"className":925},[],[927],{"type":54,"value":198},{"type":54,"value":929},", and ",{"type":49,"tag":93,"props":931,"children":933},{"className":932},[],[934],{"type":54,"value":377},{"type":54,"value":294},{"type":49,"tag":61,"props":937,"children":938},{},[939,943],{"type":49,"tag":65,"props":940,"children":941},{},[942],{"type":54,"value":637},{"type":54,"value":944},": Uses present tense, starts with an action verb, focuses on user impact, and stays under 80 characters.",{"type":49,"tag":61,"props":946,"children":947},{},[948,953],{"type":49,"tag":65,"props":949,"children":950},{},[951],{"type":54,"value":952},"Description",{"type":54,"value":954},": Adds context only when needed, focuses on user value, and stays under 600 characters.",{"type":49,"tag":61,"props":956,"children":957},{},[958,963],{"type":49,"tag":65,"props":959,"children":960},{},[961],{"type":54,"value":962},"Impact and action",{"type":54,"value":964},": Required for breaking changes and recommended for deprecations and known issues.",{"type":49,"tag":61,"props":966,"children":967},{},[968,972],{"type":49,"tag":65,"props":969,"children":970},{},[971],{"type":54,"value":695},{"type":54,"value":973},": Does not focus on implementation details, internal references, vague summaries, or duplicated title text.",{"type":49,"tag":50,"props":975,"children":976},{},[977,979,984],{"type":54,"value":978},"When the inferred type differs from the declared ",{"type":49,"tag":93,"props":980,"children":982},{"className":981},[],[983],{"type":54,"value":198},{"type":54,"value":985},", report the mismatch first, then evaluate against the type that best matches the page's actual purpose.",{"type":49,"tag":83,"props":987,"children":989},{"id":988},"step-4-generate-report",[990],{"type":54,"value":991},"Step 4: Generate report",{"type":49,"tag":202,"props":993,"children":997},{"className":994,"code":996,"language":54},[995],"language-text","## Content type check: \u003Cfile>\n\n### Detected type: \u003Ctype>\n\n### Required elements\n- ❌ Frontmatter `description`: Missing\n- ✅ Title: Present, uses correct pattern\n- ...\n\n### Best practices\n- ⚠️ Includes step-by-step instructions (overviews should link to how-to guides instead)\n- ...\n\n### Summary\nX of Y required elements present. Z best practice issues found.\n",[998],{"type":49,"tag":93,"props":999,"children":1000},{"__ignoreMap":207},[1001],{"type":54,"value":996},{"type":49,"tag":83,"props":1003,"children":1005},{"id":1004},"classify-mode-steps",[1006],{"type":54,"value":179},{"type":49,"tag":50,"props":1008,"children":1009},{},[1010,1012,1017],{"type":54,"value":1011},"Use these steps when the user describes a planned or hypothetical page rather than presenting actual content. The goal is to help them decide which content type the page should use ",{"type":49,"tag":554,"props":1013,"children":1014},{},[1015],{"type":54,"value":1016},"before",{"type":54,"value":1018}," they draft it, and to surface which required elements they'll still need to write.",{"type":49,"tag":321,"props":1020,"children":1022},{"id":1021},"step-1-classify-read-the-proposal",[1023],{"type":54,"value":1024},"Step 1 (classify): Read the proposal",{"type":49,"tag":50,"props":1026,"children":1027},{},[1028],{"type":54,"value":1029},"The user describes what they want to write. Examples:",{"type":49,"tag":57,"props":1031,"children":1032},{},[1033,1038,1043,1056],{"type":49,"tag":61,"props":1034,"children":1035},{},[1036],{"type":54,"value":1037},"\"A new step-by-step page about migrating from ECE to ECH\"",{"type":49,"tag":61,"props":1039,"children":1040},{},[1041],{"type":54,"value":1042},"\"An overview of cross-cluster search\"",{"type":49,"tag":61,"props":1044,"children":1045},{},[1046,1048,1054],{"type":54,"value":1047},"\"A page documenting the symptoms and resolution for ",{"type":49,"tag":93,"props":1049,"children":1051},{"className":1050},[],[1052],{"type":54,"value":1053},"index_not_found_exception",{"type":54,"value":1055}," errors\"",{"type":49,"tag":61,"props":1057,"children":1058},{},[1059,1061,1067],{"type":54,"value":1060},"\"A short page documenting the new ",{"type":49,"tag":93,"props":1062,"children":1064},{"className":1063},[],[1065],{"type":54,"value":1066},"--reindex-on-startup",{"type":54,"value":1068}," CLI flag, what it does, and a one-line example\"",{"type":49,"tag":50,"props":1070,"children":1071},{},[1072,1074,1079],{"type":54,"value":1073},"If the description is too vague to classify (fewer than ~10 informative words, no verbs of intent, no clear domain reference), ask ",{"type":49,"tag":65,"props":1075,"children":1076},{},[1077],{"type":54,"value":1078},"one",{"type":54,"value":1080}," focused clarifying question rather than guessing.",{"type":49,"tag":321,"props":1082,"children":1084},{"id":1083},"step-2-classify-match-against-the-content-type-definitions",[1085],{"type":54,"value":1086},"Step 2 (classify): Match against the content-type definitions",{"type":49,"tag":50,"props":1088,"children":1089},{},[1090],{"type":54,"value":1091},"Score the proposal against each content type using these definitions (the same ones Validate mode uses to grade pages — see Step 3 above for the full checklists):",{"type":49,"tag":57,"props":1093,"children":1094},{},[1095,1104,1114,1123,1144],{"type":49,"tag":61,"props":1096,"children":1097},{},[1098,1102],{"type":49,"tag":65,"props":1099,"children":1100},{},[1101],{"type":54,"value":654},{"type":54,"value":1103}," — describes what something is, how it works, and why it matters. Concept-led; long procedures and reference tables are anti-patterns.",{"type":49,"tag":61,"props":1105,"children":1106},{},[1107,1112],{"type":49,"tag":65,"props":1108,"children":1109},{},[1110],{"type":54,"value":1111},"How-to",{"type":54,"value":1113}," — accomplishes one self-contained task. Action-verb title, \"Before you begin\" or requirements, numbered steps, success checkpoint. Anti-pattern: chains many tasks or teaches broad concepts.",{"type":49,"tag":61,"props":1115,"children":1116},{},[1117,1121],{"type":49,"tag":65,"props":1118,"children":1119},{},[1120],{"type":54,"value":754},{"type":54,"value":1122}," — chains related tasks toward a meaningful learning outcome. Has objectives, prerequisites, instructional flow, checkpoints. Anti-pattern: narrow recipe or pure overview.",{"type":49,"tag":61,"props":1124,"children":1125},{},[1126,1130,1132,1136,1138,1142],{"type":49,"tag":65,"props":1127,"children":1128},{},[1129],{"type":54,"value":798},{"type":54,"value":1131}," — resolves one specific repeatable problem. Problem-focused title, ",{"type":49,"tag":65,"props":1133,"children":1134},{},[1135],{"type":54,"value":824},{"type":54,"value":1137}," section, ",{"type":49,"tag":65,"props":1139,"children":1140},{},[1141],{"type":54,"value":831},{"type":54,"value":1143}," section. Anti-pattern: generic \"Troubleshooting X\" wayfinding pages or mixing unrelated problems.",{"type":49,"tag":61,"props":1145,"children":1146},{},[1147,1151],{"type":49,"tag":65,"props":1148,"children":1149},{},[1150],{"type":54,"value":895},{"type":54,"value":1152}," — describes one user-facing product change for release notes. Action-verb title, user-impact focus, present tense. Anti-pattern: implementation-focused or vague summaries.",{"type":49,"tag":50,"props":1154,"children":1155},{},[1156],{"type":54,"value":1157},"Pick the type whose definition the proposal description most clearly invokes. If the proposal mentions sequential steps, prefer how-to over overview. If it mentions an error or symptom, prefer troubleshooting over how-to. If it mentions a concept being introduced or explained, prefer overview.",{"type":49,"tag":321,"props":1159,"children":1161},{"id":1160},"step-3-classify-check-confidence-and-assembly",[1162],{"type":54,"value":1163},"Step 3 (classify): Check confidence and assembly",{"type":49,"tag":50,"props":1165,"children":1166},{},[1167],{"type":54,"value":1168},"Assign a confidence level:",{"type":49,"tag":57,"props":1170,"children":1171},{},[1172,1182,1192],{"type":49,"tag":61,"props":1173,"children":1174},{},[1175,1180],{"type":49,"tag":65,"props":1176,"children":1177},{},[1178],{"type":54,"value":1179},"High",{"type":54,"value":1181}," — the proposal clearly invokes one type's required content (e.g., explicit steps + prerequisites = how-to; explicit Symptoms + Resolution = troubleshooting).",{"type":49,"tag":61,"props":1183,"children":1184},{},[1185,1190],{"type":49,"tag":65,"props":1186,"children":1187},{},[1188],{"type":54,"value":1189},"Medium",{"type":54,"value":1191}," — the proposal fits one type best but is missing some required elements, or fits two types partially. Suggest the user draft an outline and re-classify.",{"type":49,"tag":61,"props":1193,"children":1194},{},[1195,1200],{"type":49,"tag":65,"props":1196,"children":1197},{},[1198],{"type":54,"value":1199},"Low",{"type":54,"value":1201}," — no type fits cleanly. The proposal may belong as a section of an existing page rather than a new page. Recommend an assembly check (look for sibling pages on the same topic) before treating this as a new page.",{"type":49,"tag":321,"props":1203,"children":1205},{"id":1204},"step-4-classify-generate-classification-report",[1206],{"type":54,"value":1207},"Step 4 (classify): Generate classification report",{"type":49,"tag":202,"props":1209,"children":1212},{"className":1210,"code":1211,"language":54},[995],"## Content type classification\n\n### Best fit: \u003Ctype>\nConfidence: \u003Chigh | medium | low>\n\n### Why\n- \u003Creason 1, e.g., \"Proposal describes sequential steps and prerequisites\">\n- \u003Creason 2, e.g., \"Title pattern is action-verb\">\n\n### Required elements still to draft\n- \u003Celement from the type's required-content list, e.g., \"Before you begin section\">\n- \u003Celement>\n- ...\n\n### Alternatives considered\n- \u003Ctype 2>: \u003Cone-line reason it's a worse fit>\n- \u003Ctype 3>: \u003Cone-line reason>\n\n### Recommendation\n- \u003Cnext step based on confidence — see Step 3 (classify)>\n",[1213],{"type":49,"tag":93,"props":1214,"children":1215},{"__ignoreMap":207},[1216],{"type":54,"value":1211},{"type":49,"tag":50,"props":1218,"children":1219},{},[1220],{"type":54,"value":1221},"If no type fits cleanly (low confidence on all), say so explicitly and recommend the user check whether the content could be added as a new section of an existing page, rather than starting a new page. Do not invent a fit.",{"type":49,"tag":1223,"props":1224,"children":1225},"style",{},[1226],{"type":54,"value":1227},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1229,"total":1303},[1230,1240,1253,1259,1268,1280,1290],{"slug":1231,"name":1231,"fn":1232,"description":1233,"org":1234,"tags":1235,"stars":20,"repoUrl":21,"updatedAt":1239},"docs-applies-to-tagging","validate applies_to tags in Elastic documentation","Validate and generate applies_to tags in Elastic documentation, including for cumulative docs across versions and deployment types. Use when writing new docs pages, reviewing existing pages for correct applies_to usage, deciding whether to preserve or replace existing version-scoped content, or when content changes lifecycle state (experimental, preview, beta, GA, deprecated, removed).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1236,1237,1238],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:50:42.801473",{"slug":1241,"name":1241,"fn":1242,"description":1243,"org":1244,"tags":1245,"stars":20,"repoUrl":21,"updatedAt":1252},"docs-check-style","check documentation for Elastic style compliance","Check documentation for Elastic style guide compliance using Vale linter output and style rules. Use when writing, editing, or reviewing docs to catch voice, tone, grammar, formatting, accessibility, and word choice issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1246,1249,1250,1251],{"name":1247,"slug":1248,"type":15},"Accessibility","accessibility",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:49:36.112751",{"slug":4,"name":4,"fn":5,"description":6,"org":1254,"tags":1255,"stars":20,"repoUrl":21,"updatedAt":22},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1256,1257,1258],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},{"slug":1260,"name":1260,"fn":1261,"description":1262,"org":1263,"tags":1264,"stars":20,"repoUrl":21,"updatedAt":1267},"docs-draft-workflow-docs","draft Elastic Workflows documentation","Draft or update Elastic Workflows documentation pages in explore-analyze\u002Fworkflows\u002F — step references, use cases, how-tos, concepts, and overviews. Use when writing Workflows docs, documenting a step type, turning workflow YAML into documentation, drafting from a doc issue in docs-content or docs-content-internal, or creating a new page under the Workflows docset.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1265,1266],{"name":13,"slug":14,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:48:02.16095",{"slug":1269,"name":1269,"fn":1270,"description":1271,"org":1272,"tags":1273,"stars":20,"repoUrl":21,"updatedAt":1279},"docs-fix-changelog","improve Elastic changelog YAML files","Suggest improved text for changelog YAML files against current Elastic standards. Mirrors the pattern catalog from docs-review-changelog to provide consistent fixes. Includes type-title alignment checking and technical content assessment to catch overly technical titles that need user-focused rewrites. Features repository-aware area validation and enhanced confidence scoring. Supports single files or directories. Fetches canonical guidance to stay in sync. Use after review identifies quality issues, or when drafting new changelogs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1274,1275,1276,1277],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},{"name":1278,"slug":206,"type":15},"YAML","2026-07-12T07:48:58.570382",{"slug":1281,"name":1281,"fn":1282,"description":1283,"org":1284,"tags":1285,"stars":20,"repoUrl":21,"updatedAt":1289},"docs-flag-jargon-skill","flag Elastic jargon in documentation","Flag Elastic-internal jargon in documentation and suggest plain-language replacements. Use when reviewing, writing, or editing docs to catch terms that external readers would not understand.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1286,1287,1288],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:49:34.836748",{"slug":1291,"name":1291,"fn":1292,"description":1293,"org":1294,"tags":1295,"stars":20,"repoUrl":21,"updatedAt":1302},"docs-frontmatter-audit","audit Elastic documentation frontmatter","Audit Elastic documentation files for frontmatter completeness and correctness. Checks products, description, and navigation_title fields across a directory. Use when auditing docs metadata, checking frontmatter quality before publishing, or validating a batch of files.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1296,1299,1300,1301],{"name":1297,"slug":1298,"type":15},"Audit","audit",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"2026-07-12T07:49:39.883351",18,{"items":1305,"total":1475},[1306,1325,1342,1357,1376,1388,1398,1413,1425,1438,1449,1462],{"slug":1307,"name":1307,"fn":1308,"description":1309,"org":1310,"tags":1311,"stars":1322,"repoUrl":1323,"updatedAt":1324},"accessing-benchmark-results","retrieve and analyze Rally benchmark results","Retrieve Rally benchmark results from an external Elasticsearch metrics store. Use to list past races, get a single race's overall (per-task) results, chart a metric's trend across multiple runs, compare two races, or check whether a run converged — e.g. \"show me recent geonames races\", \"what's the service_time trend for nyc_taxis over the last 30 days?\", \"compare these two race-ids\". Applies when datastore.type = elasticsearch is set in ~\u002F.rally\u002Frally.ini.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1312,1315,1318,1319],{"name":1313,"slug":1314,"type":15},"Analytics","analytics",{"name":1316,"slug":1317,"type":15},"Data Analysis","data-analysis",{"name":9,"slug":8,"type":15},{"name":1320,"slug":1321,"type":15},"Performance","performance",2027,"https:\u002F\u002Fgithub.com\u002Felastic\u002Frally","2026-07-12T07:46:38.54144",{"slug":1326,"name":1326,"fn":1327,"description":1328,"org":1329,"tags":1330,"stars":1322,"repoUrl":1323,"updatedAt":1341},"developing-rally","develop and debug Rally source code","Work on Rally's own codebase, not running benchmarks with it. Use when setting up the dev environment, running Rally's tests or linters, navigating its source, debugging Rally's own code, or making changes to Rally itself.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1331,1334,1335,1338],{"name":1332,"slug":1333,"type":15},"Debugging","debugging",{"name":9,"slug":8,"type":15},{"name":1336,"slug":1337,"type":15},"Engineering","engineering",{"name":1339,"slug":1340,"type":15},"Local Development","local-development","2026-07-12T07:46:35.976807",{"slug":1343,"name":1343,"fn":1344,"description":1345,"org":1346,"tags":1347,"stars":1322,"repoUrl":1323,"updatedAt":1356},"running-benchmarks","run Rally benchmarks against Elasticsearch","Run Rally benchmarks (races) against Elasticsearch — an existing\u002Fexternal cluster or a Rally-provisioned distribution — and read the summary report. Use when running a race (any pipeline, track, challenge, target-hosts, or auth) or when interpreting throughput, latency, and service_time results.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1348,1349,1352,1353],{"name":9,"slug":8,"type":15},{"name":1350,"slug":1351,"type":15},"Elasticsearch","elasticsearch",{"name":1320,"slug":1321,"type":15},{"name":1354,"slug":1355,"type":15},"Testing","testing","2026-07-12T07:46:37.277964",{"slug":1358,"name":1358,"fn":1359,"description":1360,"org":1361,"tags":1362,"stars":1373,"repoUrl":1374,"updatedAt":1375},"cloud-access-management","manage Elastic Cloud organization access","Manage Elastic Cloud organization access: invite users, assign roles to Serverless projects, and create or revoke Cloud API keys. Use when granting, modifying, or auditing user access.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1363,1366,1367,1370],{"name":1364,"slug":1365,"type":15},"Cloud","cloud",{"name":9,"slug":8,"type":15},{"name":1368,"slug":1369,"type":15},"Operations","operations",{"name":1371,"slug":1372,"type":15},"Permissions","permissions",531,"https:\u002F\u002Fgithub.com\u002Felastic\u002Fagent-skills","2026-07-12T07:46:44.946285",{"slug":1377,"name":1377,"fn":1378,"description":1379,"org":1380,"tags":1381,"stars":1373,"repoUrl":1374,"updatedAt":1387},"cloud-create-project","create Elastic Cloud Serverless projects","Creates Elastic Cloud Serverless projects (Elasticsearch, Observability, or Security) via the REST API, saves credentials to file, and bootstraps a scoped Elasticsearch API key. Use when creating a new serverless project, provisioning a search or observability environment, or spinning up a new Elastic Cloud project.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1382,1383,1386],{"name":1364,"slug":1365,"type":15},{"name":1384,"slug":1385,"type":15},"Deployment","deployment",{"name":1350,"slug":1351,"type":15},"2026-07-12T07:46:42.353362",{"slug":1389,"name":1389,"fn":1390,"description":1391,"org":1392,"tags":1393,"stars":1373,"repoUrl":1374,"updatedAt":1397},"cloud-manage-project","manage Elastic Cloud Serverless projects","Manages existing Elastic Cloud Serverless projects: list, get, update, delete, reset credentials, resume, and load saved credentials. Connects to existing projects by resolving endpoints and acquiring scoped Elasticsearch API keys. Use when performing day-2 operations on serverless projects, connecting to an existing project, loading or resetting project credentials, or looking up project details.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1394,1395,1396],{"name":1364,"slug":1365,"type":15},{"name":1350,"slug":1351,"type":15},{"name":1368,"slug":1369,"type":15},"2026-07-12T07:46:41.097412",{"slug":1399,"name":1399,"fn":1400,"description":1401,"org":1402,"tags":1403,"stars":1373,"repoUrl":1374,"updatedAt":1412},"cloud-network-security","manage Elastic Cloud network security","Manage Serverless network security (traffic filters): create, update, and delete IP filters and AWS PrivateLink VPC filters. Use when restricting network access or configuring private connectivity.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1404,1405,1406,1409],{"name":1364,"slug":1365,"type":15},{"name":1350,"slug":1351,"type":15},{"name":1407,"slug":1408,"type":15},"Networking","networking",{"name":1410,"slug":1411,"type":15},"Security","security","2026-07-12T07:46:43.675992",{"slug":1414,"name":1414,"fn":1415,"description":1416,"org":1417,"tags":1418,"stars":1373,"repoUrl":1374,"updatedAt":1424},"cloud-setup","configure Elastic Cloud authentication","Configures Elastic Cloud authentication and environment defaults. Use when setting up EC_API_KEY, configuring Cloud API access, or when another cloud skill requires credentials.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1419,1422,1423],{"name":1420,"slug":1421,"type":15},"Authentication","authentication",{"name":1364,"slug":1365,"type":15},{"name":1350,"slug":1351,"type":15},"2026-07-12T07:46:39.783105",{"slug":1426,"name":1426,"fn":1427,"description":1428,"org":1429,"tags":1430,"stars":1373,"repoUrl":1374,"updatedAt":1437},"elasticsearch-audit","configure Elasticsearch security audit logs","Enable, configure, and query Elasticsearch security audit logs. Use when the task involves audit logging setup, event filtering, or investigating security incidents like failed logins.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1431,1432,1433,1436],{"name":1297,"slug":1298,"type":15},{"name":1350,"slug":1351,"type":15},{"name":1434,"slug":1435,"type":15},"Logs","logs",{"name":1410,"slug":1411,"type":15},"2026-07-12T07:47:35.092599",{"slug":1439,"name":1439,"fn":1440,"description":1441,"org":1442,"tags":1443,"stars":1373,"repoUrl":1374,"updatedAt":1448},"elasticsearch-authn","configure Elasticsearch authentication realms","Authenticate to Elasticsearch using native, file-based, LDAP\u002FAD, SAML, OIDC, Kerberos, JWT, or certificate realms. Use when connecting with credentials, choosing a realm, or managing API keys. Assumes the target realms are already configured.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1444,1445,1446,1447],{"name":1420,"slug":1421,"type":15},{"name":9,"slug":8,"type":15},{"name":1350,"slug":1351,"type":15},{"name":1410,"slug":1411,"type":15},"2026-07-12T07:47:41.474547",{"slug":1450,"name":1450,"fn":1451,"description":1452,"org":1453,"tags":1454,"stars":1373,"repoUrl":1374,"updatedAt":1461},"elasticsearch-authz","manage Elasticsearch RBAC and security roles","Manage Elasticsearch RBAC: native users, roles, role mappings, document- and field-level security. Use when creating users or roles, assigning privileges, or mapping external realms like LDAP\u002FSAML.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1455,1456,1457,1460],{"name":9,"slug":8,"type":15},{"name":1350,"slug":1351,"type":15},{"name":1458,"slug":1459,"type":15},"RBAC","rbac",{"name":1410,"slug":1411,"type":15},"2026-07-12T07:47:36.394177",{"slug":1463,"name":1463,"fn":1464,"description":1465,"org":1466,"tags":1467,"stars":1373,"repoUrl":1374,"updatedAt":1474},"elasticsearch-esql","query Elasticsearch data with ES|QL","Execute ES|QL (Elasticsearch Query Language) queries, use when the user wants to query Elasticsearch data, analyze logs, aggregate metrics, explore data, or create charts and dashboards from ES|QL results.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1468,1469,1470,1471],{"name":1313,"slug":1314,"type":15},{"name":1316,"slug":1317,"type":15},{"name":1350,"slug":1351,"type":15},{"name":1472,"slug":1473,"type":15},"SQL","sql","2026-07-12T07:47:40.249533",86]