[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-elastic-cloud-setup":3,"mdc--7i9k8j-key":33,"related-repo-elastic-cloud-setup":958,"related-org-elastic-cloud-setup":1045},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":28,"sourceUrl":31,"mdContent":32},"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},"elastic","Elastic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Felastic.png",[12,16,19],{"name":13,"slug":14,"type":15},"Authentication","authentication","tag",{"name":17,"slug":18,"type":15},"Cloud","cloud",{"name":20,"slug":21,"type":15},"Elasticsearch","elasticsearch",531,"https:\u002F\u002Fgithub.com\u002Felastic\u002Fagent-skills","2026-07-12T07:46:39.783105",null,41,[],{"repoUrl":23,"stars":22,"forks":26,"topics":29,"description":30},[],"Official Elastic Skills","https:\u002F\u002Fgithub.com\u002Felastic\u002Fagent-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fcloud\u002Fsetup","---\nname: cloud-setup\ndescription: >\n  Configures Elastic Cloud authentication and environment defaults. Use when setting\n  up EC_API_KEY, configuring Cloud API access, or when another cloud skill requires\n  credentials.\nmetadata:\n  author: elastic\n  version: 0.1.0\n---\n\n# Cloud Environment Setup\n\nConfigure Elastic Cloud authentication and preferences. All other `cloud\u002F*` skills depend on this setup.\n\n## Workflow\n\n```text\nSetup Progress:\n- [ ] Step 1: Verify API key\n- [ ] Step 2: Set defaults\n- [ ] Step 3: Validate connection\n```\n\n### Step 1: Verify API key\n\nCheck whether `EC_API_KEY` is already set:\n\n```bash\necho \"${EC_API_KEY:?Not set}\"\n```\n\nIf not set, instruct the user to set it. **Never ask the user to paste an API key into the chat** — secrets must not\nappear in conversation history.\n\nIf the user indicates they do not have an Elastic Cloud account yet, propose starting a free trial at\n[Elastic Cloud free trial](https:\u002F\u002Fcloud.elastic.co\u002Fregistration). The trial provides 14 days of full access to Elastic\nCloud Serverless with no credit card required. Once the user has registered and logged in, proceed with API key\ngeneration below.\n\nDirect the user to:\n\n1. Generate a key at [Elastic Cloud API keys](https:\u002F\u002Fcloud.elastic.co\u002Faccount\u002Fkeys). Only **Organization owners** can\n   create and manage Cloud API keys.\n1. When creating this key, include **Project Admin** privileges or higher (Org Owner) so it can create and manage\n   serverless projects.\n1. Create a `.env` file in the project root (recommended — works in sandboxed agent shells):\n\n```bash\nEC_API_KEY=your-api-key\n```\n\nAll `cloud\u002F*` scripts auto-load `.env` from the working directory — no manual sourcing needed.\n\nAlternatively, export directly in the terminal:\n\n```bash\nexport EC_API_KEY=\"your-api-key\"\n```\n\nTerminal exports might not be visible to sandboxed agents running in a separate shell session. Prefer the `.env` file\nwhen working with an agent.\n\nRemind the user that storing secrets in local files is acceptable for development, but for production or shared\nenvironments, use a centralized secrets manager (for example, HashiCorp Vault, AWS Secrets Manager, 1Password CLI) to\navoid secrets sprawl.\n\n### Step 2: Set defaults\n\nExport the base URL and default region:\n\n```bash\nexport EC_BASE_URL=\"https:\u002F\u002Fapi.elastic-cloud.com\"\nexport EC_REGION=\"gcp-us-central1\"\n```\n\nAsk the user if they want a different region. To list available regions:\n\n```bash\ncurl -s -H \"Authorization: ApiKey ${EC_API_KEY}\" \\\n  \"${EC_BASE_URL}\u002Fapi\u002Fv1\u002Fserverless\u002Fregions\" | python3 -m json.tool\n```\n\n### Step 3: Validate connection\n\nConfirm the API key works by calling the regions endpoint:\n\n```bash\ncurl -sf -H \"Authorization: ApiKey ${EC_API_KEY}\" \\\n  \"${EC_BASE_URL}\u002Fapi\u002Fv1\u002Fserverless\u002Fregions\" > \u002Fdev\u002Fnull && echo \"Authenticated.\" || echo \"Authentication failed.\"\n```\n\nIf validation fails, check:\n\n- The API key is valid and not expired\n- Network connectivity to `api.elastic-cloud.com`\n\n## Examples\n\n### First-time setup\n\n```text\nUser: set up my cloud environment\nAgent: Check if EC_API_KEY is set in your terminal. If not, generate a key at\n       https:\u002F\u002Fcloud.elastic.co\u002Faccount\u002Fkeys and run:\n       export EC_API_KEY=\"your-key\"\n       Then confirm and I'll validate the connection.\n```\n\n### Setup with custom region\n\n```text\nUser: set up cloud with eu region\nAgent: [runs setup, sets EC_REGION to user's preferred EU region]\n```\n\n## Guidelines\n\n- Never receive, echo, or log API keys, passwords, or any credentials in the chat. Instruct the user to manage secrets\n  in their terminal or using files directly.\n- Always validate the connection after setting the key.\n- Default region is `gcp-us-central1` — only change if the user requests a different region.\n- This skill is a prerequisite. Other cloud skills should refer here when `EC_API_KEY` is missing.\n\n## Environment variables\n\n| Variable      | Required | Description                                                   |\n| ------------- | -------- | ------------------------------------------------------------- |\n| `EC_API_KEY`  | Yes      | Elastic Cloud API key                                         |\n| `EC_BASE_URL` | No       | Cloud API base URL (default: `https:\u002F\u002Fapi.elastic-cloud.com`) |\n| `EC_REGION`   | No       | Default region (default: `gcp-us-central1`)                   |\n\n## Troubleshooting\n\n| Problem              | Fix                                                |\n| -------------------- | -------------------------------------------------- |\n| `401 Unauthorized`   | API key is invalid or expired — generate a new one |\n| `connection refused` | Check network access to `api.elastic-cloud.com`    |\n",{"data":34,"body":37},{"name":4,"description":6,"metadata":35},{"author":8,"version":36},"0.1.0",{"type":38,"children":39},"root",[40,49,64,71,83,90,103,155,168,184,189,240,265,284,289,329,341,346,352,357,423,428,530,536,541,666,671,691,697,703,712,718,727,733,770,776,885,891,952],{"type":41,"tag":42,"props":43,"children":45},"element","h1",{"id":44},"cloud-environment-setup",[46],{"type":47,"value":48},"text","Cloud Environment Setup",{"type":41,"tag":50,"props":51,"children":52},"p",{},[53,55,62],{"type":47,"value":54},"Configure Elastic Cloud authentication and preferences. All other ",{"type":41,"tag":56,"props":57,"children":59},"code",{"className":58},[],[60],{"type":47,"value":61},"cloud\u002F*",{"type":47,"value":63}," skills depend on this setup.",{"type":41,"tag":65,"props":66,"children":68},"h2",{"id":67},"workflow",[69],{"type":47,"value":70},"Workflow",{"type":41,"tag":72,"props":73,"children":78},"pre",{"className":74,"code":76,"language":47,"meta":77},[75],"language-text","Setup Progress:\n- [ ] Step 1: Verify API key\n- [ ] Step 2: Set defaults\n- [ ] Step 3: Validate connection\n","",[79],{"type":41,"tag":56,"props":80,"children":81},{"__ignoreMap":77},[82],{"type":47,"value":76},{"type":41,"tag":84,"props":85,"children":87},"h3",{"id":86},"step-1-verify-api-key",[88],{"type":47,"value":89},"Step 1: Verify API key",{"type":41,"tag":50,"props":91,"children":92},{},[93,95,101],{"type":47,"value":94},"Check whether ",{"type":41,"tag":56,"props":96,"children":98},{"className":97},[],[99],{"type":47,"value":100},"EC_API_KEY",{"type":47,"value":102}," is already set:",{"type":41,"tag":72,"props":104,"children":108},{"className":105,"code":106,"language":107,"meta":77,"style":77},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","echo \"${EC_API_KEY:?Not set}\"\n","bash",[109],{"type":41,"tag":56,"props":110,"children":111},{"__ignoreMap":77},[112],{"type":41,"tag":113,"props":114,"children":117},"span",{"class":115,"line":116},"line",1,[118,124,130,135,140,145,150],{"type":41,"tag":113,"props":119,"children":121},{"style":120},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[122],{"type":47,"value":123},"echo",{"type":41,"tag":113,"props":125,"children":127},{"style":126},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[128],{"type":47,"value":129}," \"${",{"type":41,"tag":113,"props":131,"children":133},{"style":132},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[134],{"type":47,"value":100},{"type":41,"tag":113,"props":136,"children":137},{"style":126},[138],{"type":47,"value":139},":?",{"type":41,"tag":113,"props":141,"children":142},{"style":132},[143],{"type":47,"value":144},"Not",{"type":41,"tag":113,"props":146,"children":147},{"style":132},[148],{"type":47,"value":149}," set",{"type":41,"tag":113,"props":151,"children":152},{"style":126},[153],{"type":47,"value":154},"}\"\n",{"type":41,"tag":50,"props":156,"children":157},{},[158,160,166],{"type":47,"value":159},"If not set, instruct the user to set it. ",{"type":41,"tag":161,"props":162,"children":163},"strong",{},[164],{"type":47,"value":165},"Never ask the user to paste an API key into the chat",{"type":47,"value":167}," — secrets must not\nappear in conversation history.",{"type":41,"tag":50,"props":169,"children":170},{},[171,173,182],{"type":47,"value":172},"If the user indicates they do not have an Elastic Cloud account yet, propose starting a free trial at\n",{"type":41,"tag":174,"props":175,"children":179},"a",{"href":176,"rel":177},"https:\u002F\u002Fcloud.elastic.co\u002Fregistration",[178],"nofollow",[180],{"type":47,"value":181},"Elastic Cloud free trial",{"type":47,"value":183},". The trial provides 14 days of full access to Elastic\nCloud Serverless with no credit card required. Once the user has registered and logged in, proceed with API key\ngeneration below.",{"type":41,"tag":50,"props":185,"children":186},{},[187],{"type":47,"value":188},"Direct the user to:",{"type":41,"tag":190,"props":191,"children":192},"ol",{},[193,215,227],{"type":41,"tag":194,"props":195,"children":196},"li",{},[197,199,206,208,213],{"type":47,"value":198},"Generate a key at ",{"type":41,"tag":174,"props":200,"children":203},{"href":201,"rel":202},"https:\u002F\u002Fcloud.elastic.co\u002Faccount\u002Fkeys",[178],[204],{"type":47,"value":205},"Elastic Cloud API keys",{"type":47,"value":207},". Only ",{"type":41,"tag":161,"props":209,"children":210},{},[211],{"type":47,"value":212},"Organization owners",{"type":47,"value":214}," can\ncreate and manage Cloud API keys.",{"type":41,"tag":194,"props":216,"children":217},{},[218,220,225],{"type":47,"value":219},"When creating this key, include ",{"type":41,"tag":161,"props":221,"children":222},{},[223],{"type":47,"value":224},"Project Admin",{"type":47,"value":226}," privileges or higher (Org Owner) so it can create and manage\nserverless projects.",{"type":41,"tag":194,"props":228,"children":229},{},[230,232,238],{"type":47,"value":231},"Create a ",{"type":41,"tag":56,"props":233,"children":235},{"className":234},[],[236],{"type":47,"value":237},".env",{"type":47,"value":239}," file in the project root (recommended — works in sandboxed agent shells):",{"type":41,"tag":72,"props":241,"children":243},{"className":105,"code":242,"language":107,"meta":77,"style":77},"EC_API_KEY=your-api-key\n",[244],{"type":41,"tag":56,"props":245,"children":246},{"__ignoreMap":77},[247],{"type":41,"tag":113,"props":248,"children":249},{"class":115,"line":116},[250,254,259],{"type":41,"tag":113,"props":251,"children":252},{"style":132},[253],{"type":47,"value":100},{"type":41,"tag":113,"props":255,"children":256},{"style":126},[257],{"type":47,"value":258},"=",{"type":41,"tag":113,"props":260,"children":262},{"style":261},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[263],{"type":47,"value":264},"your-api-key\n",{"type":41,"tag":50,"props":266,"children":267},{},[268,270,275,277,282],{"type":47,"value":269},"All ",{"type":41,"tag":56,"props":271,"children":273},{"className":272},[],[274],{"type":47,"value":61},{"type":47,"value":276}," scripts auto-load ",{"type":41,"tag":56,"props":278,"children":280},{"className":279},[],[281],{"type":47,"value":237},{"type":47,"value":283}," from the working directory — no manual sourcing needed.",{"type":41,"tag":50,"props":285,"children":286},{},[287],{"type":47,"value":288},"Alternatively, export directly in the terminal:",{"type":41,"tag":72,"props":290,"children":292},{"className":105,"code":291,"language":107,"meta":77,"style":77},"export EC_API_KEY=\"your-api-key\"\n",[293],{"type":41,"tag":56,"props":294,"children":295},{"__ignoreMap":77},[296],{"type":41,"tag":113,"props":297,"children":298},{"class":115,"line":116},[299,305,310,314,319,324],{"type":41,"tag":113,"props":300,"children":302},{"style":301},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[303],{"type":47,"value":304},"export",{"type":41,"tag":113,"props":306,"children":307},{"style":132},[308],{"type":47,"value":309}," EC_API_KEY",{"type":41,"tag":113,"props":311,"children":312},{"style":126},[313],{"type":47,"value":258},{"type":41,"tag":113,"props":315,"children":316},{"style":126},[317],{"type":47,"value":318},"\"",{"type":41,"tag":113,"props":320,"children":321},{"style":261},[322],{"type":47,"value":323},"your-api-key",{"type":41,"tag":113,"props":325,"children":326},{"style":126},[327],{"type":47,"value":328},"\"\n",{"type":41,"tag":50,"props":330,"children":331},{},[332,334,339],{"type":47,"value":333},"Terminal exports might not be visible to sandboxed agents running in a separate shell session. Prefer the ",{"type":41,"tag":56,"props":335,"children":337},{"className":336},[],[338],{"type":47,"value":237},{"type":47,"value":340}," file\nwhen working with an agent.",{"type":41,"tag":50,"props":342,"children":343},{},[344],{"type":47,"value":345},"Remind the user that storing secrets in local files is acceptable for development, but for production or shared\nenvironments, use a centralized secrets manager (for example, HashiCorp Vault, AWS Secrets Manager, 1Password CLI) to\navoid secrets sprawl.",{"type":41,"tag":84,"props":347,"children":349},{"id":348},"step-2-set-defaults",[350],{"type":47,"value":351},"Step 2: Set defaults",{"type":41,"tag":50,"props":353,"children":354},{},[355],{"type":47,"value":356},"Export the base URL and default region:",{"type":41,"tag":72,"props":358,"children":360},{"className":105,"code":359,"language":107,"meta":77,"style":77},"export EC_BASE_URL=\"https:\u002F\u002Fapi.elastic-cloud.com\"\nexport EC_REGION=\"gcp-us-central1\"\n",[361],{"type":41,"tag":56,"props":362,"children":363},{"__ignoreMap":77},[364,393],{"type":41,"tag":113,"props":365,"children":366},{"class":115,"line":116},[367,371,376,380,384,389],{"type":41,"tag":113,"props":368,"children":369},{"style":301},[370],{"type":47,"value":304},{"type":41,"tag":113,"props":372,"children":373},{"style":132},[374],{"type":47,"value":375}," EC_BASE_URL",{"type":41,"tag":113,"props":377,"children":378},{"style":126},[379],{"type":47,"value":258},{"type":41,"tag":113,"props":381,"children":382},{"style":126},[383],{"type":47,"value":318},{"type":41,"tag":113,"props":385,"children":386},{"style":261},[387],{"type":47,"value":388},"https:\u002F\u002Fapi.elastic-cloud.com",{"type":41,"tag":113,"props":390,"children":391},{"style":126},[392],{"type":47,"value":328},{"type":41,"tag":113,"props":394,"children":396},{"class":115,"line":395},2,[397,401,406,410,414,419],{"type":41,"tag":113,"props":398,"children":399},{"style":301},[400],{"type":47,"value":304},{"type":41,"tag":113,"props":402,"children":403},{"style":132},[404],{"type":47,"value":405}," EC_REGION",{"type":41,"tag":113,"props":407,"children":408},{"style":126},[409],{"type":47,"value":258},{"type":41,"tag":113,"props":411,"children":412},{"style":126},[413],{"type":47,"value":318},{"type":41,"tag":113,"props":415,"children":416},{"style":261},[417],{"type":47,"value":418},"gcp-us-central1",{"type":41,"tag":113,"props":420,"children":421},{"style":126},[422],{"type":47,"value":328},{"type":41,"tag":50,"props":424,"children":425},{},[426],{"type":47,"value":427},"Ask the user if they want a different region. To list available regions:",{"type":41,"tag":72,"props":429,"children":431},{"className":105,"code":430,"language":107,"meta":77,"style":77},"curl -s -H \"Authorization: ApiKey ${EC_API_KEY}\" \\\n  \"${EC_BASE_URL}\u002Fapi\u002Fv1\u002Fserverless\u002Fregions\" | python3 -m json.tool\n",[432],{"type":41,"tag":56,"props":433,"children":434},{"__ignoreMap":77},[435,483],{"type":41,"tag":113,"props":436,"children":437},{"class":115,"line":116},[438,444,449,454,459,464,469,473,478],{"type":41,"tag":113,"props":439,"children":441},{"style":440},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[442],{"type":47,"value":443},"curl",{"type":41,"tag":113,"props":445,"children":446},{"style":261},[447],{"type":47,"value":448}," -s",{"type":41,"tag":113,"props":450,"children":451},{"style":261},[452],{"type":47,"value":453}," -H",{"type":41,"tag":113,"props":455,"children":456},{"style":126},[457],{"type":47,"value":458}," \"",{"type":41,"tag":113,"props":460,"children":461},{"style":261},[462],{"type":47,"value":463},"Authorization: ApiKey ",{"type":41,"tag":113,"props":465,"children":466},{"style":126},[467],{"type":47,"value":468},"${",{"type":41,"tag":113,"props":470,"children":471},{"style":132},[472],{"type":47,"value":100},{"type":41,"tag":113,"props":474,"children":475},{"style":126},[476],{"type":47,"value":477},"}\"",{"type":41,"tag":113,"props":479,"children":480},{"style":132},[481],{"type":47,"value":482}," \\\n",{"type":41,"tag":113,"props":484,"children":485},{"class":115,"line":395},[486,491,496,501,506,510,515,520,525],{"type":41,"tag":113,"props":487,"children":488},{"style":126},[489],{"type":47,"value":490},"  \"${",{"type":41,"tag":113,"props":492,"children":493},{"style":132},[494],{"type":47,"value":495},"EC_BASE_URL",{"type":41,"tag":113,"props":497,"children":498},{"style":126},[499],{"type":47,"value":500},"}",{"type":41,"tag":113,"props":502,"children":503},{"style":261},[504],{"type":47,"value":505},"\u002Fapi\u002Fv1\u002Fserverless\u002Fregions",{"type":41,"tag":113,"props":507,"children":508},{"style":126},[509],{"type":47,"value":318},{"type":41,"tag":113,"props":511,"children":512},{"style":126},[513],{"type":47,"value":514}," |",{"type":41,"tag":113,"props":516,"children":517},{"style":440},[518],{"type":47,"value":519}," python3",{"type":41,"tag":113,"props":521,"children":522},{"style":261},[523],{"type":47,"value":524}," -m",{"type":41,"tag":113,"props":526,"children":527},{"style":261},[528],{"type":47,"value":529}," json.tool\n",{"type":41,"tag":84,"props":531,"children":533},{"id":532},"step-3-validate-connection",[534],{"type":47,"value":535},"Step 3: Validate connection",{"type":41,"tag":50,"props":537,"children":538},{},[539],{"type":47,"value":540},"Confirm the API key works by calling the regions endpoint:",{"type":41,"tag":72,"props":542,"children":544},{"className":105,"code":543,"language":107,"meta":77,"style":77},"curl -sf -H \"Authorization: ApiKey ${EC_API_KEY}\" \\\n  \"${EC_BASE_URL}\u002Fapi\u002Fv1\u002Fserverless\u002Fregions\" > \u002Fdev\u002Fnull && echo \"Authenticated.\" || echo \"Authentication failed.\"\n",[545],{"type":41,"tag":56,"props":546,"children":547},{"__ignoreMap":77},[548,588],{"type":41,"tag":113,"props":549,"children":550},{"class":115,"line":116},[551,555,560,564,568,572,576,580,584],{"type":41,"tag":113,"props":552,"children":553},{"style":440},[554],{"type":47,"value":443},{"type":41,"tag":113,"props":556,"children":557},{"style":261},[558],{"type":47,"value":559}," -sf",{"type":41,"tag":113,"props":561,"children":562},{"style":261},[563],{"type":47,"value":453},{"type":41,"tag":113,"props":565,"children":566},{"style":126},[567],{"type":47,"value":458},{"type":41,"tag":113,"props":569,"children":570},{"style":261},[571],{"type":47,"value":463},{"type":41,"tag":113,"props":573,"children":574},{"style":126},[575],{"type":47,"value":468},{"type":41,"tag":113,"props":577,"children":578},{"style":132},[579],{"type":47,"value":100},{"type":41,"tag":113,"props":581,"children":582},{"style":126},[583],{"type":47,"value":477},{"type":41,"tag":113,"props":585,"children":586},{"style":132},[587],{"type":47,"value":482},{"type":41,"tag":113,"props":589,"children":590},{"class":115,"line":395},[591,595,599,603,607,611,616,621,626,631,635,640,644,649,653,657,662],{"type":41,"tag":113,"props":592,"children":593},{"style":126},[594],{"type":47,"value":490},{"type":41,"tag":113,"props":596,"children":597},{"style":132},[598],{"type":47,"value":495},{"type":41,"tag":113,"props":600,"children":601},{"style":126},[602],{"type":47,"value":500},{"type":41,"tag":113,"props":604,"children":605},{"style":261},[606],{"type":47,"value":505},{"type":41,"tag":113,"props":608,"children":609},{"style":126},[610],{"type":47,"value":318},{"type":41,"tag":113,"props":612,"children":613},{"style":126},[614],{"type":47,"value":615}," >",{"type":41,"tag":113,"props":617,"children":618},{"style":261},[619],{"type":47,"value":620}," \u002Fdev\u002Fnull",{"type":41,"tag":113,"props":622,"children":623},{"style":126},[624],{"type":47,"value":625}," &&",{"type":41,"tag":113,"props":627,"children":628},{"style":120},[629],{"type":47,"value":630}," echo",{"type":41,"tag":113,"props":632,"children":633},{"style":126},[634],{"type":47,"value":458},{"type":41,"tag":113,"props":636,"children":637},{"style":261},[638],{"type":47,"value":639},"Authenticated.",{"type":41,"tag":113,"props":641,"children":642},{"style":126},[643],{"type":47,"value":318},{"type":41,"tag":113,"props":645,"children":646},{"style":126},[647],{"type":47,"value":648}," ||",{"type":41,"tag":113,"props":650,"children":651},{"style":120},[652],{"type":47,"value":630},{"type":41,"tag":113,"props":654,"children":655},{"style":126},[656],{"type":47,"value":458},{"type":41,"tag":113,"props":658,"children":659},{"style":261},[660],{"type":47,"value":661},"Authentication failed.",{"type":41,"tag":113,"props":663,"children":664},{"style":126},[665],{"type":47,"value":328},{"type":41,"tag":50,"props":667,"children":668},{},[669],{"type":47,"value":670},"If validation fails, check:",{"type":41,"tag":672,"props":673,"children":674},"ul",{},[675,680],{"type":41,"tag":194,"props":676,"children":677},{},[678],{"type":47,"value":679},"The API key is valid and not expired",{"type":41,"tag":194,"props":681,"children":682},{},[683,685],{"type":47,"value":684},"Network connectivity to ",{"type":41,"tag":56,"props":686,"children":688},{"className":687},[],[689],{"type":47,"value":690},"api.elastic-cloud.com",{"type":41,"tag":65,"props":692,"children":694},{"id":693},"examples",[695],{"type":47,"value":696},"Examples",{"type":41,"tag":84,"props":698,"children":700},{"id":699},"first-time-setup",[701],{"type":47,"value":702},"First-time setup",{"type":41,"tag":72,"props":704,"children":707},{"className":705,"code":706,"language":47,"meta":77},[75],"User: set up my cloud environment\nAgent: Check if EC_API_KEY is set in your terminal. If not, generate a key at\n       https:\u002F\u002Fcloud.elastic.co\u002Faccount\u002Fkeys and run:\n       export EC_API_KEY=\"your-key\"\n       Then confirm and I'll validate the connection.\n",[708],{"type":41,"tag":56,"props":709,"children":710},{"__ignoreMap":77},[711],{"type":47,"value":706},{"type":41,"tag":84,"props":713,"children":715},{"id":714},"setup-with-custom-region",[716],{"type":47,"value":717},"Setup with custom region",{"type":41,"tag":72,"props":719,"children":722},{"className":720,"code":721,"language":47,"meta":77},[75],"User: set up cloud with eu region\nAgent: [runs setup, sets EC_REGION to user's preferred EU region]\n",[723],{"type":41,"tag":56,"props":724,"children":725},{"__ignoreMap":77},[726],{"type":47,"value":721},{"type":41,"tag":65,"props":728,"children":730},{"id":729},"guidelines",[731],{"type":47,"value":732},"Guidelines",{"type":41,"tag":672,"props":734,"children":735},{},[736,741,746,758],{"type":41,"tag":194,"props":737,"children":738},{},[739],{"type":47,"value":740},"Never receive, echo, or log API keys, passwords, or any credentials in the chat. Instruct the user to manage secrets\nin their terminal or using files directly.",{"type":41,"tag":194,"props":742,"children":743},{},[744],{"type":47,"value":745},"Always validate the connection after setting the key.",{"type":41,"tag":194,"props":747,"children":748},{},[749,751,756],{"type":47,"value":750},"Default region is ",{"type":41,"tag":56,"props":752,"children":754},{"className":753},[],[755],{"type":47,"value":418},{"type":47,"value":757}," — only change if the user requests a different region.",{"type":41,"tag":194,"props":759,"children":760},{},[761,763,768],{"type":47,"value":762},"This skill is a prerequisite. Other cloud skills should refer here when ",{"type":41,"tag":56,"props":764,"children":766},{"className":765},[],[767],{"type":47,"value":100},{"type":47,"value":769}," is missing.",{"type":41,"tag":65,"props":771,"children":773},{"id":772},"environment-variables",[774],{"type":47,"value":775},"Environment variables",{"type":41,"tag":777,"props":778,"children":779},"table",{},[780,804],{"type":41,"tag":781,"props":782,"children":783},"thead",{},[784],{"type":41,"tag":785,"props":786,"children":787},"tr",{},[788,794,799],{"type":41,"tag":789,"props":790,"children":791},"th",{},[792],{"type":47,"value":793},"Variable",{"type":41,"tag":789,"props":795,"children":796},{},[797],{"type":47,"value":798},"Required",{"type":41,"tag":789,"props":800,"children":801},{},[802],{"type":47,"value":803},"Description",{"type":41,"tag":805,"props":806,"children":807},"tbody",{},[808,830,858],{"type":41,"tag":785,"props":809,"children":810},{},[811,820,825],{"type":41,"tag":812,"props":813,"children":814},"td",{},[815],{"type":41,"tag":56,"props":816,"children":818},{"className":817},[],[819],{"type":47,"value":100},{"type":41,"tag":812,"props":821,"children":822},{},[823],{"type":47,"value":824},"Yes",{"type":41,"tag":812,"props":826,"children":827},{},[828],{"type":47,"value":829},"Elastic Cloud API key",{"type":41,"tag":785,"props":831,"children":832},{},[833,841,846],{"type":41,"tag":812,"props":834,"children":835},{},[836],{"type":41,"tag":56,"props":837,"children":839},{"className":838},[],[840],{"type":47,"value":495},{"type":41,"tag":812,"props":842,"children":843},{},[844],{"type":47,"value":845},"No",{"type":41,"tag":812,"props":847,"children":848},{},[849,851,856],{"type":47,"value":850},"Cloud API base URL (default: ",{"type":41,"tag":56,"props":852,"children":854},{"className":853},[],[855],{"type":47,"value":388},{"type":47,"value":857},")",{"type":41,"tag":785,"props":859,"children":860},{},[861,870,874],{"type":41,"tag":812,"props":862,"children":863},{},[864],{"type":41,"tag":56,"props":865,"children":867},{"className":866},[],[868],{"type":47,"value":869},"EC_REGION",{"type":41,"tag":812,"props":871,"children":872},{},[873],{"type":47,"value":845},{"type":41,"tag":812,"props":875,"children":876},{},[877,879,884],{"type":47,"value":878},"Default region (default: ",{"type":41,"tag":56,"props":880,"children":882},{"className":881},[],[883],{"type":47,"value":418},{"type":47,"value":857},{"type":41,"tag":65,"props":886,"children":888},{"id":887},"troubleshooting",[889],{"type":47,"value":890},"Troubleshooting",{"type":41,"tag":777,"props":892,"children":893},{},[894,910],{"type":41,"tag":781,"props":895,"children":896},{},[897],{"type":41,"tag":785,"props":898,"children":899},{},[900,905],{"type":41,"tag":789,"props":901,"children":902},{},[903],{"type":47,"value":904},"Problem",{"type":41,"tag":789,"props":906,"children":907},{},[908],{"type":47,"value":909},"Fix",{"type":41,"tag":805,"props":911,"children":912},{},[913,930],{"type":41,"tag":785,"props":914,"children":915},{},[916,925],{"type":41,"tag":812,"props":917,"children":918},{},[919],{"type":41,"tag":56,"props":920,"children":922},{"className":921},[],[923],{"type":47,"value":924},"401 Unauthorized",{"type":41,"tag":812,"props":926,"children":927},{},[928],{"type":47,"value":929},"API key is invalid or expired — generate a new one",{"type":41,"tag":785,"props":931,"children":932},{},[933,942],{"type":41,"tag":812,"props":934,"children":935},{},[936],{"type":41,"tag":56,"props":937,"children":939},{"className":938},[],[940],{"type":47,"value":941},"connection refused",{"type":41,"tag":812,"props":943,"children":944},{},[945,947],{"type":47,"value":946},"Check network access to ",{"type":41,"tag":56,"props":948,"children":950},{"className":949},[],[951],{"type":47,"value":690},{"type":41,"tag":953,"props":954,"children":955},"style",{},[956],{"type":47,"value":957},"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":959,"total":1044},[960,975,987,997,1012,1018,1033],{"slug":961,"name":961,"fn":962,"description":963,"org":964,"tags":965,"stars":22,"repoUrl":23,"updatedAt":974},"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},[966,967,968,971],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":969,"slug":970,"type":15},"Operations","operations",{"name":972,"slug":973,"type":15},"Permissions","permissions","2026-07-12T07:46:44.946285",{"slug":976,"name":976,"fn":977,"description":978,"org":979,"tags":980,"stars":22,"repoUrl":23,"updatedAt":986},"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},[981,982,985],{"name":17,"slug":18,"type":15},{"name":983,"slug":984,"type":15},"Deployment","deployment",{"name":20,"slug":21,"type":15},"2026-07-12T07:46:42.353362",{"slug":988,"name":988,"fn":989,"description":990,"org":991,"tags":992,"stars":22,"repoUrl":23,"updatedAt":996},"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},[993,994,995],{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"name":969,"slug":970,"type":15},"2026-07-12T07:46:41.097412",{"slug":998,"name":998,"fn":999,"description":1000,"org":1001,"tags":1002,"stars":22,"repoUrl":23,"updatedAt":1011},"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},[1003,1004,1005,1008],{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"name":1006,"slug":1007,"type":15},"Networking","networking",{"name":1009,"slug":1010,"type":15},"Security","security","2026-07-12T07:46:43.675992",{"slug":4,"name":4,"fn":5,"description":6,"org":1013,"tags":1014,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1015,1016,1017],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"slug":1019,"name":1019,"fn":1020,"description":1021,"org":1022,"tags":1023,"stars":22,"repoUrl":23,"updatedAt":1032},"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},[1024,1027,1028,1031],{"name":1025,"slug":1026,"type":15},"Audit","audit",{"name":20,"slug":21,"type":15},{"name":1029,"slug":1030,"type":15},"Logs","logs",{"name":1009,"slug":1010,"type":15},"2026-07-12T07:47:35.092599",{"slug":1034,"name":1034,"fn":1035,"description":1036,"org":1037,"tags":1038,"stars":22,"repoUrl":23,"updatedAt":1043},"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},[1039,1040,1041,1042],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"name":1009,"slug":1010,"type":15},"2026-07-12T07:47:41.474547",35,{"items":1046,"total":1168},[1047,1066,1083,1096,1103,1109,1115,1122,1128,1135,1142,1155],{"slug":1048,"name":1048,"fn":1049,"description":1050,"org":1051,"tags":1052,"stars":1063,"repoUrl":1064,"updatedAt":1065},"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},[1053,1056,1059,1060],{"name":1054,"slug":1055,"type":15},"Analytics","analytics",{"name":1057,"slug":1058,"type":15},"Data Analysis","data-analysis",{"name":9,"slug":8,"type":15},{"name":1061,"slug":1062,"type":15},"Performance","performance",2027,"https:\u002F\u002Fgithub.com\u002Felastic\u002Frally","2026-07-12T07:46:38.54144",{"slug":1067,"name":1067,"fn":1068,"description":1069,"org":1070,"tags":1071,"stars":1063,"repoUrl":1064,"updatedAt":1082},"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},[1072,1075,1076,1079],{"name":1073,"slug":1074,"type":15},"Debugging","debugging",{"name":9,"slug":8,"type":15},{"name":1077,"slug":1078,"type":15},"Engineering","engineering",{"name":1080,"slug":1081,"type":15},"Local Development","local-development","2026-07-12T07:46:35.976807",{"slug":1084,"name":1084,"fn":1085,"description":1086,"org":1087,"tags":1088,"stars":1063,"repoUrl":1064,"updatedAt":1095},"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},[1089,1090,1091,1092],{"name":9,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"name":1061,"slug":1062,"type":15},{"name":1093,"slug":1094,"type":15},"Testing","testing","2026-07-12T07:46:37.277964",{"slug":961,"name":961,"fn":962,"description":963,"org":1097,"tags":1098,"stars":22,"repoUrl":23,"updatedAt":974},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1099,1100,1101,1102],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":969,"slug":970,"type":15},{"name":972,"slug":973,"type":15},{"slug":976,"name":976,"fn":977,"description":978,"org":1104,"tags":1105,"stars":22,"repoUrl":23,"updatedAt":986},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1106,1107,1108],{"name":17,"slug":18,"type":15},{"name":983,"slug":984,"type":15},{"name":20,"slug":21,"type":15},{"slug":988,"name":988,"fn":989,"description":990,"org":1110,"tags":1111,"stars":22,"repoUrl":23,"updatedAt":996},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1112,1113,1114],{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"name":969,"slug":970,"type":15},{"slug":998,"name":998,"fn":999,"description":1000,"org":1116,"tags":1117,"stars":22,"repoUrl":23,"updatedAt":1011},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1118,1119,1120,1121],{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"name":1006,"slug":1007,"type":15},{"name":1009,"slug":1010,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":1123,"tags":1124,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1125,1126,1127],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"slug":1019,"name":1019,"fn":1020,"description":1021,"org":1129,"tags":1130,"stars":22,"repoUrl":23,"updatedAt":1032},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1131,1132,1133,1134],{"name":1025,"slug":1026,"type":15},{"name":20,"slug":21,"type":15},{"name":1029,"slug":1030,"type":15},{"name":1009,"slug":1010,"type":15},{"slug":1034,"name":1034,"fn":1035,"description":1036,"org":1136,"tags":1137,"stars":22,"repoUrl":23,"updatedAt":1043},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1138,1139,1140,1141],{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"name":1009,"slug":1010,"type":15},{"slug":1143,"name":1143,"fn":1144,"description":1145,"org":1146,"tags":1147,"stars":22,"repoUrl":23,"updatedAt":1154},"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},[1148,1149,1150,1153],{"name":9,"slug":8,"type":15},{"name":20,"slug":21,"type":15},{"name":1151,"slug":1152,"type":15},"RBAC","rbac",{"name":1009,"slug":1010,"type":15},"2026-07-12T07:47:36.394177",{"slug":1156,"name":1156,"fn":1157,"description":1158,"org":1159,"tags":1160,"stars":22,"repoUrl":23,"updatedAt":1167},"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},[1161,1162,1163,1164],{"name":1054,"slug":1055,"type":15},{"name":1057,"slug":1058,"type":15},{"name":20,"slug":21,"type":15},{"name":1165,"slug":1166,"type":15},"SQL","sql","2026-07-12T07:47:40.249533",86]