[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openai-aiq-deploy":3,"mdc--vgbaug-key":33,"related-repo-openai-aiq-deploy":2328,"related-org-openai-aiq-deploy":2449},{"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},"aiq-deploy","deploy and manage AI-Q infrastructure","Use when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA AI-Q Blueprint infrastructure.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"openai","OpenAI","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fopenai.png",[12,16,19],{"name":13,"slug":14,"type":15},"Deployment","deployment","tag",{"name":17,"slug":18,"type":15},"AI Infrastructure","ai-infrastructure",{"name":20,"slug":21,"type":15},"Infrastructure","infrastructure",3992,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins","2026-06-30T19:00:57.102","Apache-2.0",465,[],{"repoUrl":23,"stars":22,"forks":26,"topics":29,"description":30},[],"OpenAI Plugins","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins\u002Ftree\u002FHEAD\u002Fplugins\u002Fnvidia\u002Fskills\u002Faiq-deploy","---\nname: aiq-deploy\ndescription: |\n  Use when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA AI-Q Blueprint infrastructure.\nlicense: Apache-2.0\ncompatibility: |\n  Designed for Claude Code, OpenCode, Codex, and Agent Skills-compatible tools. Requires Git, network\n  access to GitHub, and one selected runtime path: Docker Compose v2 for the default local deployment,\n  Python 3.11+ and uv for local process or CLI mode, Node.js 20+ and npm for local web UI mode, or\n  kubectl 1.28+ and Helm 3.12+ for Kubernetes and Helm mode.\nmetadata:\n  version: \"2.1.0\"\n  author: \"NVIDIA AI-Q Blueprint Team \u003Caiq-blueprint@nvidia.com>\"\n  github-url: \"https:\u002F\u002Fgithub.com\u002FNVIDIA-AI-Blueprints\u002Faiq\"\n  tags:\n    - nvidia\n    - aiq\n    - blueprint\n    - deploy\n    - operations\n    - agent-skills\nallowed-tools: Read Bash\n---\n\n# AIQ Deploy Skill\n\n## Purpose\n\nUse this skill to get a local or self-hosted NVIDIA AI-Q Blueprint server running and verified for use by\n`aiq-research`.\n\nThis skill owns setup, deployment, operational checks, troubleshooting, and shutdown. It does not run deep\nresearch itself. After deployment is healthy, hand off the verified server URL to `aiq-research`.\nThe workflow stays explicit so deployment validation and handoff are repeatable across supported agent clients.\n\n## Prerequisites\n\nUsers need:\n\n- Access to clone or update `https:\u002F\u002Fgithub.com\u002FNVIDIA-AI-Blueprints\u002Faiq`.\n- Git available in the shell.\n- One deployment runtime:\n  - Docker Engine with Docker Compose v2 for the default durable local deployment.\n  - Python 3.11+ and `uv` for local process or CLI mode.\n  - Node.js 20+ and `npm` for local browser UI development mode.\n  - `kubectl` 1.28+, Helm 3.12+, and access to a Kubernetes cluster for Helm mode.\n- Network access to GitHub, NVIDIA-hosted model endpoints, and any selected search provider.\n- Credentials stored outside chat. Hosted-model usage requires `NVIDIA_API_KEY`; web research requires at least\n  one supported search provider key such as `TAVILY_API_KEY`, `SERPER_API_KEY`, or `EXA_API_KEY`.\n- System capacity for the selected runtime. Docker Compose mode starts the AI-Q backend and PostgreSQL by default;\n  browser UI mode also uses frontend port `3000`. Self-hosted model or RAG deployments may require GPU resources.\n\nBefore writing secrets, verify `deploy\u002F.env` is ignored:\n\n```bash\ngit check-ignore deploy\u002F.env\n```\n\nExpected output: `deploy\u002F.env` or a matching ignore rule. If it is not ignored, stop and fix the ignore rule before\nplacing credentials in the file.\n\n## Instructions\n\n1. Locate or clone the AI-Q repository.\n2. Confirm the expected repository files exist.\n3. Select the deployment mode.\n4. Prepare `deploy\u002F.env` without overwriting user secrets.\n5. Check runtime prerequisites for the selected path.\n6. Start the selected deployment.\n7. Run basic validation.\n8. Report the verified `AIQ_SERVER_URL` for `aiq-research`.\n9. Ask whether to run optional deep research completion validation.\n\n### Step 1 - Locate or clone AI-Q\n\nIf no AI-Q checkout exists, read `references\u002Flocate-or-clone.md` before cloning. In an existing checkout, confirm the\nrequired files:\n\n```bash\npwd\ntest -f pyproject.toml\ntest -f deploy\u002F.env.example\ntest -d configs\n```\n\nExpected output: `pwd` prints the AI-Q repository path; the `test` commands exit with status 0 and no output.\n\n### Step 2 - Select the deployment mode\n\nIf the user asks to install, deploy, set up, or run AI-Q without naming a mode, ask:\n\n```text\nHow do you want to run AI-Q?\n\n1. Skill backend - backend-only service for aiq-research w\u002Fo browser UI.\n2. CLI - interactive terminal AI-Q.\n3. UI - browser AI-Q app with backend and frontend.\n4. Custom - choose an existing AI-Q config or review advanced customization docs before deployment.\n```\n\nWait for the user's answer before starting services.\n\nDo not ask this question when the user already specified a mode, such as Docker Compose, Helm, UI, CLI, or Agent Skill\nbackend. Do not ask the full mode question when `aiq-research` routed here because a deep research request needs a\nbackend. In that case, prefer Agent Skill backend and ask only for permission to start it if needed.\n\n### Step 3 - Prepare environment and secrets\n\nRead `references\u002Fenv-and-secrets.md` before changing `deploy\u002F.env`.\n\n```bash\nif [ ! -f deploy\u002F.env ]; then\n  cp deploy\u002F.env.example deploy\u002F.env\n  echo \"created deploy\u002F.env from deploy\u002F.env.example\"\nfi\n```\n\nExpected output when the file is missing: `created deploy\u002F.env from deploy\u002F.env.example`. Expected output when the file\nalready exists: no output, and the existing file is preserved.\n\nNever print secret values. If credentials are missing, ask the user to update `deploy\u002F.env`; do not ask them to paste\nsecret values into chat.\n\n### Step 4 - Route to the selected deployment path\n\nMatch the user request, then read the referenced file before acting:\n\n| User Intent | Reference |\n|---|---|\n| No AI-Q checkout exists, install AIQ, clone AIQ, locate repo | `references\u002Flocate-or-clone.md` |\n| Configure environment, check API keys, inspect `.env` | `references\u002Fenv-and-secrets.md` |\n| Choose an AI-Q workflow config, understand config files, set `BACKEND_CONFIG` or `CONFIG_FILE` | `references\u002Fconfigs.md` |\n| Backend-only local server for `aiq-research`, AIQ as an Agent Skill | `references\u002Fskill-backend.md` |\n| Terminal assistant, CLI-only run, no web UI | `references\u002Fterminal-cli.md` |\n| Quick local development run, start UI\u002Fbackend without containers | `references\u002Flocal-web.md` |\n| Default durable local deployment, Docker Compose, containers, PostgreSQL | `references\u002Fdocker-compose.md` |\n| Kubernetes, Helm, cluster deployment | `references\u002Fkubernetes-helm.md` |\n| Foundational RAG \u002F FRAG integration | `references\u002Ffrag.md` |\n| Basic health checks, shallow smoke checks, handoff to `aiq-research` | `references\u002Fvalidation.md` |\n| Optional deep research completion validation | `references\u002Fend-to-end-validation.md` |\n| Logs, unhealthy services, port conflicts, config failures | `references\u002Ftroubleshooting.md` |\n| Stop services, restart, rebuild, safe cleanup | `references\u002Fshutdown.md` |\n\n### Step 5 - Validate and hand off\n\nAfter startup, read `references\u002Fvalidation.md` and run the appropriate checks for the selected mode. For the default\nlocal backend, verify health:\n\n```bash\ncurl -sf http:\u002F\u002Flocalhost:8000\u002Fhealth\n```\n\nExpected output: a successful JSON health response or an empty successful response depending on the server build. If the\ncommand fails, read `references\u002Ftroubleshooting.md` and diagnose before claiming the backend is ready.\n\n`aiq-research` needs a reachable AI-Q server URL. If the backend is on the default port, no extra configuration is\nneeded:\n\n```bash\nAIQ_SERVER_URL=http:\u002F\u002Flocalhost:8000\n```\n\nIf the backend runs elsewhere, tell the user to set:\n\n```bash\nexport AIQ_SERVER_URL=\"http:\u002F\u002Flocalhost:\u003CPORT>\"\n```\n\nDo not continue into deep research or deep research completion validation unless the user asks for it or confirms the\npost-deploy validation prompt. This skill's success criterion is a deployed and basically validated server, not report\ngeneration quality.\n\n## Version Compatibility\n\n**IMPORTANT:** This skill is designed for NVIDIA AI-Q Blueprint version 2.1.0.\n\nSemantic Versioning Compatibility Rules:\n\n```text\nSkill version: X.Y.Z\nBlueprint version: A.B.C\n\nCompatible IF:\n1. A == X (Major versions MUST match)\n2. B >= Y (Minor version must be equal or greater)\n3. C can be anything (Patch version does not affect compatibility)\n```\n\nExamples:\n\n- Skill version 2.1.0 is compatible with Blueprint version 2.1.0.\n- Skill version 2.1.0 is compatible with Blueprint version 2.2.0.\n- Skill version 2.1.0 is compatible with Blueprint version 2.1.5.\n- Skill version 2.1.0 is not compatible with Blueprint version 3.0.0.\n- Skill version 2.1.0 is not compatible with Blueprint version 2.0.0.\n\nIf your Blueprint version is not compatible:\n\n1. Check for an updated skill version matching your Blueprint version.\n2. Use a Blueprint version compatible with this skill.\n3. Proceed with caution only when the user accepts the compatibility risk; deployment commands or config names may have\n   changed.\n\n## Security Best Practices\n\n- Never print secret values. Check only whether required environment variables are set.\n- Store credentials in `deploy\u002F.env` or environment variables, not in chat transcripts, shell history, committed files,\n  or example commands.\n- Do not overwrite `deploy\u002F.env` when it already exists.\n- Ask before destructive cleanup such as deleting Docker volumes with `down -v`.\n- Do not claim FRAG is ready unless both `RAG_SERVER_URL` and `RAG_INGEST_URL` are configured and reachable.\n- Run verification commands yourself when possible.\n\n## Limitations\n\n- This skill prepares and validates AI-Q infrastructure; it does not judge deep research report quality.\n- It cannot provide or inspect secret values. Users must configure credentials outside chat.\n- Helm, FRAG, custom config, and self-hosted model paths depend on infrastructure the user controls.\n- Destructive cleanup, such as deleting Docker volumes, requires explicit user approval.\n\n## Examples\n\n### Example 1: Deploy a backend-only Skill server with Docker Compose\n\n```bash\ntest -f deploy\u002F.env || cp deploy\u002F.env.example deploy\u002F.env\ngit check-ignore deploy\u002F.env\ncd deploy\u002Fcompose\nBUILD_TARGET=release docker compose --env-file ..\u002F.env -f docker-compose.yaml config --quiet\nBUILD_TARGET=release docker compose --env-file ..\u002F.env -f docker-compose.yaml up -d --build aiq-agent\ncurl -sf http:\u002F\u002Flocalhost:8000\u002Fhealth\n```\n\nExpected output:\n\n```text\ndeploy\u002F.env\n\u003Cdocker compose starts aiq-agent and dependencies>\n\u003Chealth endpoint returns a successful response>\n```\n\nIf Docker, ports, credentials, or health checks fail, read `references\u002Ftroubleshooting.md` before retrying.\n\n### Example 2: Hand off a non-default backend URL to aiq-research\n\n```bash\nexport AIQ_SERVER_URL=\"http:\u002F\u002Flocalhost:8100\"\ncurl -sf \"$AIQ_SERVER_URL\u002Fhealth\"\n```\n\nExpected output: a successful health response. Then tell the user to keep `AIQ_SERVER_URL` set before invoking\n`aiq-research`.\n\n## References\n\n| Topic | Documentation |\n|---|---|\n| Locate or clone AI-Q | `references\u002Flocate-or-clone.md` |\n| Environment and secrets | `references\u002Fenv-and-secrets.md` |\n| Workflow configs | `references\u002Fconfigs.md` |\n| Agent Skill backend | `references\u002Fskill-backend.md` |\n| CLI deployment | `references\u002Fterminal-cli.md` |\n| Local web deployment | `references\u002Flocal-web.md` |\n| Docker Compose deployment | `references\u002Fdocker-compose.md` |\n| Kubernetes and Helm deployment | `references\u002Fkubernetes-helm.md` |\n| FRAG integration | `references\u002Ffrag.md` |\n| Basic validation | `references\u002Fvalidation.md` |\n| End-to-end validation | `references\u002Fend-to-end-validation.md` |\n| Troubleshooting | `references\u002Ftroubleshooting.md` |\n| Shutdown and cleanup | `references\u002Fshutdown.md` |\n\n## Common Issues\n\n### Issue: Backend port is already in use\n\n**Symptoms:**\n\n- Docker Compose fails to bind port `8000`.\n- `curl -sf http:\u002F\u002Flocalhost:8000\u002Fhealth` reaches an unexpected service or fails.\n\n**Causes:**\n\n- Another AI-Q backend or local development server is already running.\n- `PORT` in `deploy\u002F.env` conflicts with an existing process.\n\n**Solutions:**\n\n1. Identify the process:\n   ```bash\n   lsof -nP -iTCP:8000 -sTCP:LISTEN\n   ```\n2. Either stop the conflicting process with the user's approval or set a different port in `deploy\u002F.env`, such as\n   `PORT=8100`.\n3. Restart the selected deployment path and verify:\n   ```bash\n   curl -sf http:\u002F\u002Flocalhost:8100\u002Fhealth\n   ```\n\n### Issue: Required credentials are missing\n\n**Symptoms:**\n\n- Infrastructure starts, but model-backed chat or research requests fail.\n- Logs mention unauthorized, forbidden, invalid key, or missing provider configuration.\n\n**Causes:**\n\n- `NVIDIA_API_KEY` is missing or empty.\n- No supported search provider key is configured for web research.\n\n**Solutions:**\n\n1. Check presence without printing values by following `references\u002Fenv-and-secrets.md`.\n2. Ask the user to update `deploy\u002F.env`; do not ask them to paste secrets into chat.\n3. Rerun `references\u002Fvalidation.md` after the user updates credentials.\n\n### Issue: Backend is healthy but not compatible with aiq-research\n\n**Symptoms:**\n\n- `\u002Fhealth` succeeds, but `\u002Fchat` or `\u002Fv1\u002Fjobs\u002Fasync\u002Fagents` fails.\n- `aiq-research` reports that async agents are unavailable.\n\n**Causes:**\n\n- The selected config is CLI-only or does not expose the web\u002FAPI backend expected by the skill.\n- `BACKEND_CONFIG` or `CONFIG_FILE` points at the wrong AI-Q config.\n\n**Solutions:**\n\n1. Read `references\u002Fconfigs.md` and confirm the selected config is API-enabled.\n2. For the default Skill backend, use `configs\u002Fconfig_web_default_llamaindex.yml`.\n3. Restart the backend and rerun `references\u002Fvalidation.md`.\n\n### Issue: Docker cleanup would remove useful state\n\n**Symptoms:**\n\n- Troubleshooting suggests `docker compose down -v`.\n- The user may have local PostgreSQL job or checkpoint data they want to keep.\n\n**Causes:**\n\n- `down -v` removes Docker volumes.\n- Rebuilds and restarts are often enough for config or image changes.\n\n**Solutions:**\n\n1. Prefer a normal restart from `references\u002Fshutdown.md`.\n2. Ask for explicit approval before running volume deletion.\n3. After cleanup, rerun deployment and validation from the selected route.\n",{"data":34,"body":48},{"name":4,"description":6,"license":25,"compatibility":35,"metadata":36,"allowed-tools":47},"Designed for Claude Code, OpenCode, Codex, and Agent Skills-compatible tools. Requires Git, network\naccess to GitHub, and one selected runtime path: Docker Compose v2 for the default local deployment,\nPython 3.11+ and uv for local process or CLI mode, Node.js 20+ and npm for local web UI mode, or\nkubectl 1.28+ and Helm 3.12+ for Kubernetes and Helm mode.\n",{"version":37,"author":38,"github-url":39,"tags":40},"2.1.0","NVIDIA AI-Q Blueprint Team \u003Caiq-blueprint@nvidia.com>","https:\u002F\u002Fgithub.com\u002FNVIDIA-AI-Blueprints\u002Faiq",[41,42,43,44,45,46],"nvidia","aiq","blueprint","deploy","operations","agent-skills","Read Bash",{"type":49,"children":50},"root",[51,60,67,82,94,100,105,230,243,277,289,295,365,372,385,455,474,480,485,495,500,512,518,537,632,644,656,662,667,946,952,964,989,1001,1011,1035,1040,1079,1084,1090,1101,1106,1115,1120,1148,1153,1171,1177,1247,1253,1276,1282,1288,1488,1493,1502,1514,1520,1584,1602,1608,1838,1844,1850,1858,1884,1892,1918,1926,2011,2017,2024,2037,2044,2062,2069,2107,2113,2120,2158,2165,2189,2196,2233,2239,2246,2266,2273,2291,2298,2322],{"type":52,"tag":53,"props":54,"children":56},"element","h1",{"id":55},"aiq-deploy-skill",[57],{"type":58,"value":59},"text","AIQ Deploy Skill",{"type":52,"tag":61,"props":62,"children":64},"h2",{"id":63},"purpose",[65],{"type":58,"value":66},"Purpose",{"type":52,"tag":68,"props":69,"children":70},"p",{},[71,73,80],{"type":58,"value":72},"Use this skill to get a local or self-hosted NVIDIA AI-Q Blueprint server running and verified for use by\n",{"type":52,"tag":74,"props":75,"children":77},"code",{"className":76},[],[78],{"type":58,"value":79},"aiq-research",{"type":58,"value":81},".",{"type":52,"tag":68,"props":83,"children":84},{},[85,87,92],{"type":58,"value":86},"This skill owns setup, deployment, operational checks, troubleshooting, and shutdown. It does not run deep\nresearch itself. After deployment is healthy, hand off the verified server URL to ",{"type":52,"tag":74,"props":88,"children":90},{"className":89},[],[91],{"type":58,"value":79},{"type":58,"value":93},".\nThe workflow stays explicit so deployment validation and handoff are repeatable across supported agent clients.",{"type":52,"tag":61,"props":95,"children":97},{"id":96},"prerequisites",[98],{"type":58,"value":99},"Prerequisites",{"type":52,"tag":68,"props":101,"children":102},{},[103],{"type":58,"value":104},"Users need:",{"type":52,"tag":106,"props":107,"children":108},"ul",{},[109,121,126,176,181,217],{"type":52,"tag":110,"props":111,"children":112},"li",{},[113,115,120],{"type":58,"value":114},"Access to clone or update ",{"type":52,"tag":74,"props":116,"children":118},{"className":117},[],[119],{"type":58,"value":39},{"type":58,"value":81},{"type":52,"tag":110,"props":122,"children":123},{},[124],{"type":58,"value":125},"Git available in the shell.",{"type":52,"tag":110,"props":127,"children":128},{},[129,131],{"type":58,"value":130},"One deployment runtime:\n",{"type":52,"tag":106,"props":132,"children":133},{},[134,139,152,165],{"type":52,"tag":110,"props":135,"children":136},{},[137],{"type":58,"value":138},"Docker Engine with Docker Compose v2 for the default durable local deployment.",{"type":52,"tag":110,"props":140,"children":141},{},[142,144,150],{"type":58,"value":143},"Python 3.11+ and ",{"type":52,"tag":74,"props":145,"children":147},{"className":146},[],[148],{"type":58,"value":149},"uv",{"type":58,"value":151}," for local process or CLI mode.",{"type":52,"tag":110,"props":153,"children":154},{},[155,157,163],{"type":58,"value":156},"Node.js 20+ and ",{"type":52,"tag":74,"props":158,"children":160},{"className":159},[],[161],{"type":58,"value":162},"npm",{"type":58,"value":164}," for local browser UI development mode.",{"type":52,"tag":110,"props":166,"children":167},{},[168,174],{"type":52,"tag":74,"props":169,"children":171},{"className":170},[],[172],{"type":58,"value":173},"kubectl",{"type":58,"value":175}," 1.28+, Helm 3.12+, and access to a Kubernetes cluster for Helm mode.",{"type":52,"tag":110,"props":177,"children":178},{},[179],{"type":58,"value":180},"Network access to GitHub, NVIDIA-hosted model endpoints, and any selected search provider.",{"type":52,"tag":110,"props":182,"children":183},{},[184,186,192,194,200,202,208,210,216],{"type":58,"value":185},"Credentials stored outside chat. Hosted-model usage requires ",{"type":52,"tag":74,"props":187,"children":189},{"className":188},[],[190],{"type":58,"value":191},"NVIDIA_API_KEY",{"type":58,"value":193},"; web research requires at least\none supported search provider key such as ",{"type":52,"tag":74,"props":195,"children":197},{"className":196},[],[198],{"type":58,"value":199},"TAVILY_API_KEY",{"type":58,"value":201},", ",{"type":52,"tag":74,"props":203,"children":205},{"className":204},[],[206],{"type":58,"value":207},"SERPER_API_KEY",{"type":58,"value":209},", or ",{"type":52,"tag":74,"props":211,"children":213},{"className":212},[],[214],{"type":58,"value":215},"EXA_API_KEY",{"type":58,"value":81},{"type":52,"tag":110,"props":218,"children":219},{},[220,222,228],{"type":58,"value":221},"System capacity for the selected runtime. Docker Compose mode starts the AI-Q backend and PostgreSQL by default;\nbrowser UI mode also uses frontend port ",{"type":52,"tag":74,"props":223,"children":225},{"className":224},[],[226],{"type":58,"value":227},"3000",{"type":58,"value":229},". Self-hosted model or RAG deployments may require GPU resources.",{"type":52,"tag":68,"props":231,"children":232},{},[233,235,241],{"type":58,"value":234},"Before writing secrets, verify ",{"type":52,"tag":74,"props":236,"children":238},{"className":237},[],[239],{"type":58,"value":240},"deploy\u002F.env",{"type":58,"value":242}," is ignored:",{"type":52,"tag":244,"props":245,"children":250},"pre",{"className":246,"code":247,"language":248,"meta":249,"style":249},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","git check-ignore deploy\u002F.env\n","bash","",[251],{"type":52,"tag":74,"props":252,"children":253},{"__ignoreMap":249},[254],{"type":52,"tag":255,"props":256,"children":259},"span",{"class":257,"line":258},"line",1,[260,266,272],{"type":52,"tag":255,"props":261,"children":263},{"style":262},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[264],{"type":58,"value":265},"git",{"type":52,"tag":255,"props":267,"children":269},{"style":268},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[270],{"type":58,"value":271}," check-ignore",{"type":52,"tag":255,"props":273,"children":274},{"style":268},[275],{"type":58,"value":276}," deploy\u002F.env\n",{"type":52,"tag":68,"props":278,"children":279},{},[280,282,287],{"type":58,"value":281},"Expected output: ",{"type":52,"tag":74,"props":283,"children":285},{"className":284},[],[286],{"type":58,"value":240},{"type":58,"value":288}," or a matching ignore rule. If it is not ignored, stop and fix the ignore rule before\nplacing credentials in the file.",{"type":52,"tag":61,"props":290,"children":292},{"id":291},"instructions",[293],{"type":58,"value":294},"Instructions",{"type":52,"tag":296,"props":297,"children":298},"ol",{},[299,304,309,314,326,331,336,341,360],{"type":52,"tag":110,"props":300,"children":301},{},[302],{"type":58,"value":303},"Locate or clone the AI-Q repository.",{"type":52,"tag":110,"props":305,"children":306},{},[307],{"type":58,"value":308},"Confirm the expected repository files exist.",{"type":52,"tag":110,"props":310,"children":311},{},[312],{"type":58,"value":313},"Select the deployment mode.",{"type":52,"tag":110,"props":315,"children":316},{},[317,319,324],{"type":58,"value":318},"Prepare ",{"type":52,"tag":74,"props":320,"children":322},{"className":321},[],[323],{"type":58,"value":240},{"type":58,"value":325}," without overwriting user secrets.",{"type":52,"tag":110,"props":327,"children":328},{},[329],{"type":58,"value":330},"Check runtime prerequisites for the selected path.",{"type":52,"tag":110,"props":332,"children":333},{},[334],{"type":58,"value":335},"Start the selected deployment.",{"type":52,"tag":110,"props":337,"children":338},{},[339],{"type":58,"value":340},"Run basic validation.",{"type":52,"tag":110,"props":342,"children":343},{},[344,346,352,354,359],{"type":58,"value":345},"Report the verified ",{"type":52,"tag":74,"props":347,"children":349},{"className":348},[],[350],{"type":58,"value":351},"AIQ_SERVER_URL",{"type":58,"value":353}," for ",{"type":52,"tag":74,"props":355,"children":357},{"className":356},[],[358],{"type":58,"value":79},{"type":58,"value":81},{"type":52,"tag":110,"props":361,"children":362},{},[363],{"type":58,"value":364},"Ask whether to run optional deep research completion validation.",{"type":52,"tag":366,"props":367,"children":369},"h3",{"id":368},"step-1-locate-or-clone-ai-q",[370],{"type":58,"value":371},"Step 1 - Locate or clone AI-Q",{"type":52,"tag":68,"props":373,"children":374},{},[375,377,383],{"type":58,"value":376},"If no AI-Q checkout exists, read ",{"type":52,"tag":74,"props":378,"children":380},{"className":379},[],[381],{"type":58,"value":382},"references\u002Flocate-or-clone.md",{"type":58,"value":384}," before cloning. In an existing checkout, confirm the\nrequired files:",{"type":52,"tag":244,"props":386,"children":388},{"className":246,"code":387,"language":248,"meta":249,"style":249},"pwd\ntest -f pyproject.toml\ntest -f deploy\u002F.env.example\ntest -d configs\n",[389],{"type":52,"tag":74,"props":390,"children":391},{"__ignoreMap":249},[392,401,420,437],{"type":52,"tag":255,"props":393,"children":394},{"class":257,"line":258},[395],{"type":52,"tag":255,"props":396,"children":398},{"style":397},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[399],{"type":58,"value":400},"pwd\n",{"type":52,"tag":255,"props":402,"children":404},{"class":257,"line":403},2,[405,410,415],{"type":52,"tag":255,"props":406,"children":407},{"style":397},[408],{"type":58,"value":409},"test",{"type":52,"tag":255,"props":411,"children":412},{"style":268},[413],{"type":58,"value":414}," -f",{"type":52,"tag":255,"props":416,"children":417},{"style":268},[418],{"type":58,"value":419}," pyproject.toml\n",{"type":52,"tag":255,"props":421,"children":423},{"class":257,"line":422},3,[424,428,432],{"type":52,"tag":255,"props":425,"children":426},{"style":397},[427],{"type":58,"value":409},{"type":52,"tag":255,"props":429,"children":430},{"style":268},[431],{"type":58,"value":414},{"type":52,"tag":255,"props":433,"children":434},{"style":268},[435],{"type":58,"value":436}," deploy\u002F.env.example\n",{"type":52,"tag":255,"props":438,"children":440},{"class":257,"line":439},4,[441,445,450],{"type":52,"tag":255,"props":442,"children":443},{"style":397},[444],{"type":58,"value":409},{"type":52,"tag":255,"props":446,"children":447},{"style":268},[448],{"type":58,"value":449}," -d",{"type":52,"tag":255,"props":451,"children":452},{"style":268},[453],{"type":58,"value":454}," configs\n",{"type":52,"tag":68,"props":456,"children":457},{},[458,459,465,467,472],{"type":58,"value":281},{"type":52,"tag":74,"props":460,"children":462},{"className":461},[],[463],{"type":58,"value":464},"pwd",{"type":58,"value":466}," prints the AI-Q repository path; the ",{"type":52,"tag":74,"props":468,"children":470},{"className":469},[],[471],{"type":58,"value":409},{"type":58,"value":473}," commands exit with status 0 and no output.",{"type":52,"tag":366,"props":475,"children":477},{"id":476},"step-2-select-the-deployment-mode",[478],{"type":58,"value":479},"Step 2 - Select the deployment mode",{"type":52,"tag":68,"props":481,"children":482},{},[483],{"type":58,"value":484},"If the user asks to install, deploy, set up, or run AI-Q without naming a mode, ask:",{"type":52,"tag":244,"props":486,"children":490},{"className":487,"code":489,"language":58,"meta":249},[488],"language-text","How do you want to run AI-Q?\n\n1. Skill backend - backend-only service for aiq-research w\u002Fo browser UI.\n2. CLI - interactive terminal AI-Q.\n3. UI - browser AI-Q app with backend and frontend.\n4. Custom - choose an existing AI-Q config or review advanced customization docs before deployment.\n",[491],{"type":52,"tag":74,"props":492,"children":493},{"__ignoreMap":249},[494],{"type":58,"value":489},{"type":52,"tag":68,"props":496,"children":497},{},[498],{"type":58,"value":499},"Wait for the user's answer before starting services.",{"type":52,"tag":68,"props":501,"children":502},{},[503,505,510],{"type":58,"value":504},"Do not ask this question when the user already specified a mode, such as Docker Compose, Helm, UI, CLI, or Agent Skill\nbackend. Do not ask the full mode question when ",{"type":52,"tag":74,"props":506,"children":508},{"className":507},[],[509],{"type":58,"value":79},{"type":58,"value":511}," routed here because a deep research request needs a\nbackend. In that case, prefer Agent Skill backend and ask only for permission to start it if needed.",{"type":52,"tag":366,"props":513,"children":515},{"id":514},"step-3-prepare-environment-and-secrets",[516],{"type":58,"value":517},"Step 3 - Prepare environment and secrets",{"type":52,"tag":68,"props":519,"children":520},{},[521,523,529,531,536],{"type":58,"value":522},"Read ",{"type":52,"tag":74,"props":524,"children":526},{"className":525},[],[527],{"type":58,"value":528},"references\u002Fenv-and-secrets.md",{"type":58,"value":530}," before changing ",{"type":52,"tag":74,"props":532,"children":534},{"className":533},[],[535],{"type":58,"value":240},{"type":58,"value":81},{"type":52,"tag":244,"props":538,"children":540},{"className":246,"code":539,"language":248,"meta":249,"style":249},"if [ ! -f deploy\u002F.env ]; then\n  cp deploy\u002F.env.example deploy\u002F.env\n  echo \"created deploy\u002F.env from deploy\u002F.env.example\"\nfi\n",[541],{"type":52,"tag":74,"props":542,"children":543},{"__ignoreMap":249},[544,584,601,624],{"type":52,"tag":255,"props":545,"children":546},{"class":257,"line":258},[547,553,559,564,568,574,579],{"type":52,"tag":255,"props":548,"children":550},{"style":549},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[551],{"type":58,"value":552},"if",{"type":52,"tag":255,"props":554,"children":556},{"style":555},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[557],{"type":58,"value":558}," [",{"type":52,"tag":255,"props":560,"children":561},{"style":555},[562],{"type":58,"value":563}," !",{"type":52,"tag":255,"props":565,"children":566},{"style":555},[567],{"type":58,"value":414},{"type":52,"tag":255,"props":569,"children":571},{"style":570},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[572],{"type":58,"value":573}," deploy\u002F.env ",{"type":52,"tag":255,"props":575,"children":576},{"style":555},[577],{"type":58,"value":578},"];",{"type":52,"tag":255,"props":580,"children":581},{"style":549},[582],{"type":58,"value":583}," then\n",{"type":52,"tag":255,"props":585,"children":586},{"class":257,"line":403},[587,592,597],{"type":52,"tag":255,"props":588,"children":589},{"style":262},[590],{"type":58,"value":591},"  cp",{"type":52,"tag":255,"props":593,"children":594},{"style":268},[595],{"type":58,"value":596}," deploy\u002F.env.example",{"type":52,"tag":255,"props":598,"children":599},{"style":268},[600],{"type":58,"value":276},{"type":52,"tag":255,"props":602,"children":603},{"class":257,"line":422},[604,609,614,619],{"type":52,"tag":255,"props":605,"children":606},{"style":397},[607],{"type":58,"value":608},"  echo",{"type":52,"tag":255,"props":610,"children":611},{"style":555},[612],{"type":58,"value":613}," \"",{"type":52,"tag":255,"props":615,"children":616},{"style":268},[617],{"type":58,"value":618},"created deploy\u002F.env from deploy\u002F.env.example",{"type":52,"tag":255,"props":620,"children":621},{"style":555},[622],{"type":58,"value":623},"\"\n",{"type":52,"tag":255,"props":625,"children":626},{"class":257,"line":439},[627],{"type":52,"tag":255,"props":628,"children":629},{"style":549},[630],{"type":58,"value":631},"fi\n",{"type":52,"tag":68,"props":633,"children":634},{},[635,637,642],{"type":58,"value":636},"Expected output when the file is missing: ",{"type":52,"tag":74,"props":638,"children":640},{"className":639},[],[641],{"type":58,"value":618},{"type":58,"value":643},". Expected output when the file\nalready exists: no output, and the existing file is preserved.",{"type":52,"tag":68,"props":645,"children":646},{},[647,649,654],{"type":58,"value":648},"Never print secret values. If credentials are missing, ask the user to update ",{"type":52,"tag":74,"props":650,"children":652},{"className":651},[],[653],{"type":58,"value":240},{"type":58,"value":655},"; do not ask them to paste\nsecret values into chat.",{"type":52,"tag":366,"props":657,"children":659},{"id":658},"step-4-route-to-the-selected-deployment-path",[660],{"type":58,"value":661},"Step 4 - Route to the selected deployment path",{"type":52,"tag":68,"props":663,"children":664},{},[665],{"type":58,"value":666},"Match the user request, then read the referenced file before acting:",{"type":52,"tag":668,"props":669,"children":670},"table",{},[671,690],{"type":52,"tag":672,"props":673,"children":674},"thead",{},[675],{"type":52,"tag":676,"props":677,"children":678},"tr",{},[679,685],{"type":52,"tag":680,"props":681,"children":682},"th",{},[683],{"type":58,"value":684},"User Intent",{"type":52,"tag":680,"props":686,"children":687},{},[688],{"type":58,"value":689},"Reference",{"type":52,"tag":691,"props":692,"children":693},"tbody",{},[694,711,733,764,788,805,822,839,856,873,895,912,929],{"type":52,"tag":676,"props":695,"children":696},{},[697,703],{"type":52,"tag":698,"props":699,"children":700},"td",{},[701],{"type":58,"value":702},"No AI-Q checkout exists, install AIQ, clone AIQ, locate repo",{"type":52,"tag":698,"props":704,"children":705},{},[706],{"type":52,"tag":74,"props":707,"children":709},{"className":708},[],[710],{"type":58,"value":382},{"type":52,"tag":676,"props":712,"children":713},{},[714,725],{"type":52,"tag":698,"props":715,"children":716},{},[717,719],{"type":58,"value":718},"Configure environment, check API keys, inspect ",{"type":52,"tag":74,"props":720,"children":722},{"className":721},[],[723],{"type":58,"value":724},".env",{"type":52,"tag":698,"props":726,"children":727},{},[728],{"type":52,"tag":74,"props":729,"children":731},{"className":730},[],[732],{"type":58,"value":528},{"type":52,"tag":676,"props":734,"children":735},{},[736,755],{"type":52,"tag":698,"props":737,"children":738},{},[739,741,747,749],{"type":58,"value":740},"Choose an AI-Q workflow config, understand config files, set ",{"type":52,"tag":74,"props":742,"children":744},{"className":743},[],[745],{"type":58,"value":746},"BACKEND_CONFIG",{"type":58,"value":748}," or ",{"type":52,"tag":74,"props":750,"children":752},{"className":751},[],[753],{"type":58,"value":754},"CONFIG_FILE",{"type":52,"tag":698,"props":756,"children":757},{},[758],{"type":52,"tag":74,"props":759,"children":761},{"className":760},[],[762],{"type":58,"value":763},"references\u002Fconfigs.md",{"type":52,"tag":676,"props":765,"children":766},{},[767,779],{"type":52,"tag":698,"props":768,"children":769},{},[770,772,777],{"type":58,"value":771},"Backend-only local server for ",{"type":52,"tag":74,"props":773,"children":775},{"className":774},[],[776],{"type":58,"value":79},{"type":58,"value":778},", AIQ as an Agent Skill",{"type":52,"tag":698,"props":780,"children":781},{},[782],{"type":52,"tag":74,"props":783,"children":785},{"className":784},[],[786],{"type":58,"value":787},"references\u002Fskill-backend.md",{"type":52,"tag":676,"props":789,"children":790},{},[791,796],{"type":52,"tag":698,"props":792,"children":793},{},[794],{"type":58,"value":795},"Terminal assistant, CLI-only run, no web UI",{"type":52,"tag":698,"props":797,"children":798},{},[799],{"type":52,"tag":74,"props":800,"children":802},{"className":801},[],[803],{"type":58,"value":804},"references\u002Fterminal-cli.md",{"type":52,"tag":676,"props":806,"children":807},{},[808,813],{"type":52,"tag":698,"props":809,"children":810},{},[811],{"type":58,"value":812},"Quick local development run, start UI\u002Fbackend without containers",{"type":52,"tag":698,"props":814,"children":815},{},[816],{"type":52,"tag":74,"props":817,"children":819},{"className":818},[],[820],{"type":58,"value":821},"references\u002Flocal-web.md",{"type":52,"tag":676,"props":823,"children":824},{},[825,830],{"type":52,"tag":698,"props":826,"children":827},{},[828],{"type":58,"value":829},"Default durable local deployment, Docker Compose, containers, PostgreSQL",{"type":52,"tag":698,"props":831,"children":832},{},[833],{"type":52,"tag":74,"props":834,"children":836},{"className":835},[],[837],{"type":58,"value":838},"references\u002Fdocker-compose.md",{"type":52,"tag":676,"props":840,"children":841},{},[842,847],{"type":52,"tag":698,"props":843,"children":844},{},[845],{"type":58,"value":846},"Kubernetes, Helm, cluster deployment",{"type":52,"tag":698,"props":848,"children":849},{},[850],{"type":52,"tag":74,"props":851,"children":853},{"className":852},[],[854],{"type":58,"value":855},"references\u002Fkubernetes-helm.md",{"type":52,"tag":676,"props":857,"children":858},{},[859,864],{"type":52,"tag":698,"props":860,"children":861},{},[862],{"type":58,"value":863},"Foundational RAG \u002F FRAG integration",{"type":52,"tag":698,"props":865,"children":866},{},[867],{"type":52,"tag":74,"props":868,"children":870},{"className":869},[],[871],{"type":58,"value":872},"references\u002Ffrag.md",{"type":52,"tag":676,"props":874,"children":875},{},[876,886],{"type":52,"tag":698,"props":877,"children":878},{},[879,881],{"type":58,"value":880},"Basic health checks, shallow smoke checks, handoff to ",{"type":52,"tag":74,"props":882,"children":884},{"className":883},[],[885],{"type":58,"value":79},{"type":52,"tag":698,"props":887,"children":888},{},[889],{"type":52,"tag":74,"props":890,"children":892},{"className":891},[],[893],{"type":58,"value":894},"references\u002Fvalidation.md",{"type":52,"tag":676,"props":896,"children":897},{},[898,903],{"type":52,"tag":698,"props":899,"children":900},{},[901],{"type":58,"value":902},"Optional deep research completion validation",{"type":52,"tag":698,"props":904,"children":905},{},[906],{"type":52,"tag":74,"props":907,"children":909},{"className":908},[],[910],{"type":58,"value":911},"references\u002Fend-to-end-validation.md",{"type":52,"tag":676,"props":913,"children":914},{},[915,920],{"type":52,"tag":698,"props":916,"children":917},{},[918],{"type":58,"value":919},"Logs, unhealthy services, port conflicts, config failures",{"type":52,"tag":698,"props":921,"children":922},{},[923],{"type":52,"tag":74,"props":924,"children":926},{"className":925},[],[927],{"type":58,"value":928},"references\u002Ftroubleshooting.md",{"type":52,"tag":676,"props":930,"children":931},{},[932,937],{"type":52,"tag":698,"props":933,"children":934},{},[935],{"type":58,"value":936},"Stop services, restart, rebuild, safe cleanup",{"type":52,"tag":698,"props":938,"children":939},{},[940],{"type":52,"tag":74,"props":941,"children":943},{"className":942},[],[944],{"type":58,"value":945},"references\u002Fshutdown.md",{"type":52,"tag":366,"props":947,"children":949},{"id":948},"step-5-validate-and-hand-off",[950],{"type":58,"value":951},"Step 5 - Validate and hand off",{"type":52,"tag":68,"props":953,"children":954},{},[955,957,962],{"type":58,"value":956},"After startup, read ",{"type":52,"tag":74,"props":958,"children":960},{"className":959},[],[961],{"type":58,"value":894},{"type":58,"value":963}," and run the appropriate checks for the selected mode. For the default\nlocal backend, verify health:",{"type":52,"tag":244,"props":965,"children":967},{"className":246,"code":966,"language":248,"meta":249,"style":249},"curl -sf http:\u002F\u002Flocalhost:8000\u002Fhealth\n",[968],{"type":52,"tag":74,"props":969,"children":970},{"__ignoreMap":249},[971],{"type":52,"tag":255,"props":972,"children":973},{"class":257,"line":258},[974,979,984],{"type":52,"tag":255,"props":975,"children":976},{"style":262},[977],{"type":58,"value":978},"curl",{"type":52,"tag":255,"props":980,"children":981},{"style":268},[982],{"type":58,"value":983}," -sf",{"type":52,"tag":255,"props":985,"children":986},{"style":268},[987],{"type":58,"value":988}," http:\u002F\u002Flocalhost:8000\u002Fhealth\n",{"type":52,"tag":68,"props":990,"children":991},{},[992,994,999],{"type":58,"value":993},"Expected output: a successful JSON health response or an empty successful response depending on the server build. If the\ncommand fails, read ",{"type":52,"tag":74,"props":995,"children":997},{"className":996},[],[998],{"type":58,"value":928},{"type":58,"value":1000}," and diagnose before claiming the backend is ready.",{"type":52,"tag":68,"props":1002,"children":1003},{},[1004,1009],{"type":52,"tag":74,"props":1005,"children":1007},{"className":1006},[],[1008],{"type":58,"value":79},{"type":58,"value":1010}," needs a reachable AI-Q server URL. If the backend is on the default port, no extra configuration is\nneeded:",{"type":52,"tag":244,"props":1012,"children":1014},{"className":246,"code":1013,"language":248,"meta":249,"style":249},"AIQ_SERVER_URL=http:\u002F\u002Flocalhost:8000\n",[1015],{"type":52,"tag":74,"props":1016,"children":1017},{"__ignoreMap":249},[1018],{"type":52,"tag":255,"props":1019,"children":1020},{"class":257,"line":258},[1021,1025,1030],{"type":52,"tag":255,"props":1022,"children":1023},{"style":570},[1024],{"type":58,"value":351},{"type":52,"tag":255,"props":1026,"children":1027},{"style":555},[1028],{"type":58,"value":1029},"=",{"type":52,"tag":255,"props":1031,"children":1032},{"style":268},[1033],{"type":58,"value":1034},"http:\u002F\u002Flocalhost:8000\n",{"type":52,"tag":68,"props":1036,"children":1037},{},[1038],{"type":58,"value":1039},"If the backend runs elsewhere, tell the user to set:",{"type":52,"tag":244,"props":1041,"children":1043},{"className":246,"code":1042,"language":248,"meta":249,"style":249},"export AIQ_SERVER_URL=\"http:\u002F\u002Flocalhost:\u003CPORT>\"\n",[1044],{"type":52,"tag":74,"props":1045,"children":1046},{"__ignoreMap":249},[1047],{"type":52,"tag":255,"props":1048,"children":1049},{"class":257,"line":258},[1050,1056,1061,1065,1070,1075],{"type":52,"tag":255,"props":1051,"children":1053},{"style":1052},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1054],{"type":58,"value":1055},"export",{"type":52,"tag":255,"props":1057,"children":1058},{"style":570},[1059],{"type":58,"value":1060}," AIQ_SERVER_URL",{"type":52,"tag":255,"props":1062,"children":1063},{"style":555},[1064],{"type":58,"value":1029},{"type":52,"tag":255,"props":1066,"children":1067},{"style":555},[1068],{"type":58,"value":1069},"\"",{"type":52,"tag":255,"props":1071,"children":1072},{"style":268},[1073],{"type":58,"value":1074},"http:\u002F\u002Flocalhost:\u003CPORT>",{"type":52,"tag":255,"props":1076,"children":1077},{"style":555},[1078],{"type":58,"value":623},{"type":52,"tag":68,"props":1080,"children":1081},{},[1082],{"type":58,"value":1083},"Do not continue into deep research or deep research completion validation unless the user asks for it or confirms the\npost-deploy validation prompt. This skill's success criterion is a deployed and basically validated server, not report\ngeneration quality.",{"type":52,"tag":61,"props":1085,"children":1087},{"id":1086},"version-compatibility",[1088],{"type":58,"value":1089},"Version Compatibility",{"type":52,"tag":68,"props":1091,"children":1092},{},[1093,1099],{"type":52,"tag":1094,"props":1095,"children":1096},"strong",{},[1097],{"type":58,"value":1098},"IMPORTANT:",{"type":58,"value":1100}," This skill is designed for NVIDIA AI-Q Blueprint version 2.1.0.",{"type":52,"tag":68,"props":1102,"children":1103},{},[1104],{"type":58,"value":1105},"Semantic Versioning Compatibility Rules:",{"type":52,"tag":244,"props":1107,"children":1110},{"className":1108,"code":1109,"language":58,"meta":249},[488],"Skill version: X.Y.Z\nBlueprint version: A.B.C\n\nCompatible IF:\n1. A == X (Major versions MUST match)\n2. B >= Y (Minor version must be equal or greater)\n3. C can be anything (Patch version does not affect compatibility)\n",[1111],{"type":52,"tag":74,"props":1112,"children":1113},{"__ignoreMap":249},[1114],{"type":58,"value":1109},{"type":52,"tag":68,"props":1116,"children":1117},{},[1118],{"type":58,"value":1119},"Examples:",{"type":52,"tag":106,"props":1121,"children":1122},{},[1123,1128,1133,1138,1143],{"type":52,"tag":110,"props":1124,"children":1125},{},[1126],{"type":58,"value":1127},"Skill version 2.1.0 is compatible with Blueprint version 2.1.0.",{"type":52,"tag":110,"props":1129,"children":1130},{},[1131],{"type":58,"value":1132},"Skill version 2.1.0 is compatible with Blueprint version 2.2.0.",{"type":52,"tag":110,"props":1134,"children":1135},{},[1136],{"type":58,"value":1137},"Skill version 2.1.0 is compatible with Blueprint version 2.1.5.",{"type":52,"tag":110,"props":1139,"children":1140},{},[1141],{"type":58,"value":1142},"Skill version 2.1.0 is not compatible with Blueprint version 3.0.0.",{"type":52,"tag":110,"props":1144,"children":1145},{},[1146],{"type":58,"value":1147},"Skill version 2.1.0 is not compatible with Blueprint version 2.0.0.",{"type":52,"tag":68,"props":1149,"children":1150},{},[1151],{"type":58,"value":1152},"If your Blueprint version is not compatible:",{"type":52,"tag":296,"props":1154,"children":1155},{},[1156,1161,1166],{"type":52,"tag":110,"props":1157,"children":1158},{},[1159],{"type":58,"value":1160},"Check for an updated skill version matching your Blueprint version.",{"type":52,"tag":110,"props":1162,"children":1163},{},[1164],{"type":58,"value":1165},"Use a Blueprint version compatible with this skill.",{"type":52,"tag":110,"props":1167,"children":1168},{},[1169],{"type":58,"value":1170},"Proceed with caution only when the user accepts the compatibility risk; deployment commands or config names may have\nchanged.",{"type":52,"tag":61,"props":1172,"children":1174},{"id":1173},"security-best-practices",[1175],{"type":58,"value":1176},"Security Best Practices",{"type":52,"tag":106,"props":1178,"children":1179},{},[1180,1185,1197,1209,1221,1242],{"type":52,"tag":110,"props":1181,"children":1182},{},[1183],{"type":58,"value":1184},"Never print secret values. Check only whether required environment variables are set.",{"type":52,"tag":110,"props":1186,"children":1187},{},[1188,1190,1195],{"type":58,"value":1189},"Store credentials in ",{"type":52,"tag":74,"props":1191,"children":1193},{"className":1192},[],[1194],{"type":58,"value":240},{"type":58,"value":1196}," or environment variables, not in chat transcripts, shell history, committed files,\nor example commands.",{"type":52,"tag":110,"props":1198,"children":1199},{},[1200,1202,1207],{"type":58,"value":1201},"Do not overwrite ",{"type":52,"tag":74,"props":1203,"children":1205},{"className":1204},[],[1206],{"type":58,"value":240},{"type":58,"value":1208}," when it already exists.",{"type":52,"tag":110,"props":1210,"children":1211},{},[1212,1214,1220],{"type":58,"value":1213},"Ask before destructive cleanup such as deleting Docker volumes with ",{"type":52,"tag":74,"props":1215,"children":1217},{"className":1216},[],[1218],{"type":58,"value":1219},"down -v",{"type":58,"value":81},{"type":52,"tag":110,"props":1222,"children":1223},{},[1224,1226,1232,1234,1240],{"type":58,"value":1225},"Do not claim FRAG is ready unless both ",{"type":52,"tag":74,"props":1227,"children":1229},{"className":1228},[],[1230],{"type":58,"value":1231},"RAG_SERVER_URL",{"type":58,"value":1233}," and ",{"type":52,"tag":74,"props":1235,"children":1237},{"className":1236},[],[1238],{"type":58,"value":1239},"RAG_INGEST_URL",{"type":58,"value":1241}," are configured and reachable.",{"type":52,"tag":110,"props":1243,"children":1244},{},[1245],{"type":58,"value":1246},"Run verification commands yourself when possible.",{"type":52,"tag":61,"props":1248,"children":1250},{"id":1249},"limitations",[1251],{"type":58,"value":1252},"Limitations",{"type":52,"tag":106,"props":1254,"children":1255},{},[1256,1261,1266,1271],{"type":52,"tag":110,"props":1257,"children":1258},{},[1259],{"type":58,"value":1260},"This skill prepares and validates AI-Q infrastructure; it does not judge deep research report quality.",{"type":52,"tag":110,"props":1262,"children":1263},{},[1264],{"type":58,"value":1265},"It cannot provide or inspect secret values. Users must configure credentials outside chat.",{"type":52,"tag":110,"props":1267,"children":1268},{},[1269],{"type":58,"value":1270},"Helm, FRAG, custom config, and self-hosted model paths depend on infrastructure the user controls.",{"type":52,"tag":110,"props":1272,"children":1273},{},[1274],{"type":58,"value":1275},"Destructive cleanup, such as deleting Docker volumes, requires explicit user approval.",{"type":52,"tag":61,"props":1277,"children":1279},{"id":1278},"examples",[1280],{"type":58,"value":1281},"Examples",{"type":52,"tag":366,"props":1283,"children":1285},{"id":1284},"example-1-deploy-a-backend-only-skill-server-with-docker-compose",[1286],{"type":58,"value":1287},"Example 1: Deploy a backend-only Skill server with Docker Compose",{"type":52,"tag":244,"props":1289,"children":1291},{"className":246,"code":1290,"language":248,"meta":249,"style":249},"test -f deploy\u002F.env || cp deploy\u002F.env.example deploy\u002F.env\ngit check-ignore deploy\u002F.env\ncd deploy\u002Fcompose\nBUILD_TARGET=release docker compose --env-file ..\u002F.env -f docker-compose.yaml config --quiet\nBUILD_TARGET=release docker compose --env-file ..\u002F.env -f docker-compose.yaml up -d --build aiq-agent\ncurl -sf http:\u002F\u002Flocalhost:8000\u002Fhealth\n",[1292],{"type":52,"tag":74,"props":1293,"children":1294},{"__ignoreMap":249},[1295,1329,1344,1357,1413,1472],{"type":52,"tag":255,"props":1296,"children":1297},{"class":257,"line":258},[1298,1302,1306,1311,1316,1321,1325],{"type":52,"tag":255,"props":1299,"children":1300},{"style":397},[1301],{"type":58,"value":409},{"type":52,"tag":255,"props":1303,"children":1304},{"style":268},[1305],{"type":58,"value":414},{"type":52,"tag":255,"props":1307,"children":1308},{"style":268},[1309],{"type":58,"value":1310}," deploy\u002F.env",{"type":52,"tag":255,"props":1312,"children":1313},{"style":555},[1314],{"type":58,"value":1315}," ||",{"type":52,"tag":255,"props":1317,"children":1318},{"style":262},[1319],{"type":58,"value":1320}," cp",{"type":52,"tag":255,"props":1322,"children":1323},{"style":268},[1324],{"type":58,"value":596},{"type":52,"tag":255,"props":1326,"children":1327},{"style":268},[1328],{"type":58,"value":276},{"type":52,"tag":255,"props":1330,"children":1331},{"class":257,"line":403},[1332,1336,1340],{"type":52,"tag":255,"props":1333,"children":1334},{"style":262},[1335],{"type":58,"value":265},{"type":52,"tag":255,"props":1337,"children":1338},{"style":268},[1339],{"type":58,"value":271},{"type":52,"tag":255,"props":1341,"children":1342},{"style":268},[1343],{"type":58,"value":276},{"type":52,"tag":255,"props":1345,"children":1346},{"class":257,"line":422},[1347,1352],{"type":52,"tag":255,"props":1348,"children":1349},{"style":397},[1350],{"type":58,"value":1351},"cd",{"type":52,"tag":255,"props":1353,"children":1354},{"style":268},[1355],{"type":58,"value":1356}," deploy\u002Fcompose\n",{"type":52,"tag":255,"props":1358,"children":1359},{"class":257,"line":439},[1360,1365,1369,1374,1379,1384,1389,1394,1398,1403,1408],{"type":52,"tag":255,"props":1361,"children":1362},{"style":570},[1363],{"type":58,"value":1364},"BUILD_TARGET",{"type":52,"tag":255,"props":1366,"children":1367},{"style":555},[1368],{"type":58,"value":1029},{"type":52,"tag":255,"props":1370,"children":1371},{"style":268},[1372],{"type":58,"value":1373},"release",{"type":52,"tag":255,"props":1375,"children":1376},{"style":262},[1377],{"type":58,"value":1378}," docker",{"type":52,"tag":255,"props":1380,"children":1381},{"style":268},[1382],{"type":58,"value":1383}," compose",{"type":52,"tag":255,"props":1385,"children":1386},{"style":268},[1387],{"type":58,"value":1388}," --env-file",{"type":52,"tag":255,"props":1390,"children":1391},{"style":268},[1392],{"type":58,"value":1393}," ..\u002F.env",{"type":52,"tag":255,"props":1395,"children":1396},{"style":268},[1397],{"type":58,"value":414},{"type":52,"tag":255,"props":1399,"children":1400},{"style":268},[1401],{"type":58,"value":1402}," docker-compose.yaml",{"type":52,"tag":255,"props":1404,"children":1405},{"style":268},[1406],{"type":58,"value":1407}," config",{"type":52,"tag":255,"props":1409,"children":1410},{"style":268},[1411],{"type":58,"value":1412}," --quiet\n",{"type":52,"tag":255,"props":1414,"children":1416},{"class":257,"line":1415},5,[1417,1421,1425,1429,1433,1437,1441,1445,1449,1453,1458,1462,1467],{"type":52,"tag":255,"props":1418,"children":1419},{"style":570},[1420],{"type":58,"value":1364},{"type":52,"tag":255,"props":1422,"children":1423},{"style":555},[1424],{"type":58,"value":1029},{"type":52,"tag":255,"props":1426,"children":1427},{"style":268},[1428],{"type":58,"value":1373},{"type":52,"tag":255,"props":1430,"children":1431},{"style":262},[1432],{"type":58,"value":1378},{"type":52,"tag":255,"props":1434,"children":1435},{"style":268},[1436],{"type":58,"value":1383},{"type":52,"tag":255,"props":1438,"children":1439},{"style":268},[1440],{"type":58,"value":1388},{"type":52,"tag":255,"props":1442,"children":1443},{"style":268},[1444],{"type":58,"value":1393},{"type":52,"tag":255,"props":1446,"children":1447},{"style":268},[1448],{"type":58,"value":414},{"type":52,"tag":255,"props":1450,"children":1451},{"style":268},[1452],{"type":58,"value":1402},{"type":52,"tag":255,"props":1454,"children":1455},{"style":268},[1456],{"type":58,"value":1457}," up",{"type":52,"tag":255,"props":1459,"children":1460},{"style":268},[1461],{"type":58,"value":449},{"type":52,"tag":255,"props":1463,"children":1464},{"style":268},[1465],{"type":58,"value":1466}," --build",{"type":52,"tag":255,"props":1468,"children":1469},{"style":268},[1470],{"type":58,"value":1471}," aiq-agent\n",{"type":52,"tag":255,"props":1473,"children":1475},{"class":257,"line":1474},6,[1476,1480,1484],{"type":52,"tag":255,"props":1477,"children":1478},{"style":262},[1479],{"type":58,"value":978},{"type":52,"tag":255,"props":1481,"children":1482},{"style":268},[1483],{"type":58,"value":983},{"type":52,"tag":255,"props":1485,"children":1486},{"style":268},[1487],{"type":58,"value":988},{"type":52,"tag":68,"props":1489,"children":1490},{},[1491],{"type":58,"value":1492},"Expected output:",{"type":52,"tag":244,"props":1494,"children":1497},{"className":1495,"code":1496,"language":58,"meta":249},[488],"deploy\u002F.env\n\u003Cdocker compose starts aiq-agent and dependencies>\n\u003Chealth endpoint returns a successful response>\n",[1498],{"type":52,"tag":74,"props":1499,"children":1500},{"__ignoreMap":249},[1501],{"type":58,"value":1496},{"type":52,"tag":68,"props":1503,"children":1504},{},[1505,1507,1512],{"type":58,"value":1506},"If Docker, ports, credentials, or health checks fail, read ",{"type":52,"tag":74,"props":1508,"children":1510},{"className":1509},[],[1511],{"type":58,"value":928},{"type":58,"value":1513}," before retrying.",{"type":52,"tag":366,"props":1515,"children":1517},{"id":1516},"example-2-hand-off-a-non-default-backend-url-to-aiq-research",[1518],{"type":58,"value":1519},"Example 2: Hand off a non-default backend URL to aiq-research",{"type":52,"tag":244,"props":1521,"children":1523},{"className":246,"code":1522,"language":248,"meta":249,"style":249},"export AIQ_SERVER_URL=\"http:\u002F\u002Flocalhost:8100\"\ncurl -sf \"$AIQ_SERVER_URL\u002Fhealth\"\n",[1524],{"type":52,"tag":74,"props":1525,"children":1526},{"__ignoreMap":249},[1527,1555],{"type":52,"tag":255,"props":1528,"children":1529},{"class":257,"line":258},[1530,1534,1538,1542,1546,1551],{"type":52,"tag":255,"props":1531,"children":1532},{"style":1052},[1533],{"type":58,"value":1055},{"type":52,"tag":255,"props":1535,"children":1536},{"style":570},[1537],{"type":58,"value":1060},{"type":52,"tag":255,"props":1539,"children":1540},{"style":555},[1541],{"type":58,"value":1029},{"type":52,"tag":255,"props":1543,"children":1544},{"style":555},[1545],{"type":58,"value":1069},{"type":52,"tag":255,"props":1547,"children":1548},{"style":268},[1549],{"type":58,"value":1550},"http:\u002F\u002Flocalhost:8100",{"type":52,"tag":255,"props":1552,"children":1553},{"style":555},[1554],{"type":58,"value":623},{"type":52,"tag":255,"props":1556,"children":1557},{"class":257,"line":403},[1558,1562,1566,1570,1575,1580],{"type":52,"tag":255,"props":1559,"children":1560},{"style":262},[1561],{"type":58,"value":978},{"type":52,"tag":255,"props":1563,"children":1564},{"style":268},[1565],{"type":58,"value":983},{"type":52,"tag":255,"props":1567,"children":1568},{"style":555},[1569],{"type":58,"value":613},{"type":52,"tag":255,"props":1571,"children":1572},{"style":570},[1573],{"type":58,"value":1574},"$AIQ_SERVER_URL",{"type":52,"tag":255,"props":1576,"children":1577},{"style":268},[1578],{"type":58,"value":1579},"\u002Fhealth",{"type":52,"tag":255,"props":1581,"children":1582},{"style":555},[1583],{"type":58,"value":623},{"type":52,"tag":68,"props":1585,"children":1586},{},[1587,1589,1594,1596,1601],{"type":58,"value":1588},"Expected output: a successful health response. Then tell the user to keep ",{"type":52,"tag":74,"props":1590,"children":1592},{"className":1591},[],[1593],{"type":58,"value":351},{"type":58,"value":1595}," set before invoking\n",{"type":52,"tag":74,"props":1597,"children":1599},{"className":1598},[],[1600],{"type":58,"value":79},{"type":58,"value":81},{"type":52,"tag":61,"props":1603,"children":1605},{"id":1604},"references",[1606],{"type":58,"value":1607},"References",{"type":52,"tag":668,"props":1609,"children":1610},{},[1611,1627],{"type":52,"tag":672,"props":1612,"children":1613},{},[1614],{"type":52,"tag":676,"props":1615,"children":1616},{},[1617,1622],{"type":52,"tag":680,"props":1618,"children":1619},{},[1620],{"type":58,"value":1621},"Topic",{"type":52,"tag":680,"props":1623,"children":1624},{},[1625],{"type":58,"value":1626},"Documentation",{"type":52,"tag":691,"props":1628,"children":1629},{},[1630,1646,1662,1678,1694,1710,1726,1742,1758,1774,1790,1806,1822],{"type":52,"tag":676,"props":1631,"children":1632},{},[1633,1638],{"type":52,"tag":698,"props":1634,"children":1635},{},[1636],{"type":58,"value":1637},"Locate or clone AI-Q",{"type":52,"tag":698,"props":1639,"children":1640},{},[1641],{"type":52,"tag":74,"props":1642,"children":1644},{"className":1643},[],[1645],{"type":58,"value":382},{"type":52,"tag":676,"props":1647,"children":1648},{},[1649,1654],{"type":52,"tag":698,"props":1650,"children":1651},{},[1652],{"type":58,"value":1653},"Environment and secrets",{"type":52,"tag":698,"props":1655,"children":1656},{},[1657],{"type":52,"tag":74,"props":1658,"children":1660},{"className":1659},[],[1661],{"type":58,"value":528},{"type":52,"tag":676,"props":1663,"children":1664},{},[1665,1670],{"type":52,"tag":698,"props":1666,"children":1667},{},[1668],{"type":58,"value":1669},"Workflow configs",{"type":52,"tag":698,"props":1671,"children":1672},{},[1673],{"type":52,"tag":74,"props":1674,"children":1676},{"className":1675},[],[1677],{"type":58,"value":763},{"type":52,"tag":676,"props":1679,"children":1680},{},[1681,1686],{"type":52,"tag":698,"props":1682,"children":1683},{},[1684],{"type":58,"value":1685},"Agent Skill backend",{"type":52,"tag":698,"props":1687,"children":1688},{},[1689],{"type":52,"tag":74,"props":1690,"children":1692},{"className":1691},[],[1693],{"type":58,"value":787},{"type":52,"tag":676,"props":1695,"children":1696},{},[1697,1702],{"type":52,"tag":698,"props":1698,"children":1699},{},[1700],{"type":58,"value":1701},"CLI deployment",{"type":52,"tag":698,"props":1703,"children":1704},{},[1705],{"type":52,"tag":74,"props":1706,"children":1708},{"className":1707},[],[1709],{"type":58,"value":804},{"type":52,"tag":676,"props":1711,"children":1712},{},[1713,1718],{"type":52,"tag":698,"props":1714,"children":1715},{},[1716],{"type":58,"value":1717},"Local web deployment",{"type":52,"tag":698,"props":1719,"children":1720},{},[1721],{"type":52,"tag":74,"props":1722,"children":1724},{"className":1723},[],[1725],{"type":58,"value":821},{"type":52,"tag":676,"props":1727,"children":1728},{},[1729,1734],{"type":52,"tag":698,"props":1730,"children":1731},{},[1732],{"type":58,"value":1733},"Docker Compose deployment",{"type":52,"tag":698,"props":1735,"children":1736},{},[1737],{"type":52,"tag":74,"props":1738,"children":1740},{"className":1739},[],[1741],{"type":58,"value":838},{"type":52,"tag":676,"props":1743,"children":1744},{},[1745,1750],{"type":52,"tag":698,"props":1746,"children":1747},{},[1748],{"type":58,"value":1749},"Kubernetes and Helm deployment",{"type":52,"tag":698,"props":1751,"children":1752},{},[1753],{"type":52,"tag":74,"props":1754,"children":1756},{"className":1755},[],[1757],{"type":58,"value":855},{"type":52,"tag":676,"props":1759,"children":1760},{},[1761,1766],{"type":52,"tag":698,"props":1762,"children":1763},{},[1764],{"type":58,"value":1765},"FRAG integration",{"type":52,"tag":698,"props":1767,"children":1768},{},[1769],{"type":52,"tag":74,"props":1770,"children":1772},{"className":1771},[],[1773],{"type":58,"value":872},{"type":52,"tag":676,"props":1775,"children":1776},{},[1777,1782],{"type":52,"tag":698,"props":1778,"children":1779},{},[1780],{"type":58,"value":1781},"Basic validation",{"type":52,"tag":698,"props":1783,"children":1784},{},[1785],{"type":52,"tag":74,"props":1786,"children":1788},{"className":1787},[],[1789],{"type":58,"value":894},{"type":52,"tag":676,"props":1791,"children":1792},{},[1793,1798],{"type":52,"tag":698,"props":1794,"children":1795},{},[1796],{"type":58,"value":1797},"End-to-end validation",{"type":52,"tag":698,"props":1799,"children":1800},{},[1801],{"type":52,"tag":74,"props":1802,"children":1804},{"className":1803},[],[1805],{"type":58,"value":911},{"type":52,"tag":676,"props":1807,"children":1808},{},[1809,1814],{"type":52,"tag":698,"props":1810,"children":1811},{},[1812],{"type":58,"value":1813},"Troubleshooting",{"type":52,"tag":698,"props":1815,"children":1816},{},[1817],{"type":52,"tag":74,"props":1818,"children":1820},{"className":1819},[],[1821],{"type":58,"value":928},{"type":52,"tag":676,"props":1823,"children":1824},{},[1825,1830],{"type":52,"tag":698,"props":1826,"children":1827},{},[1828],{"type":58,"value":1829},"Shutdown and cleanup",{"type":52,"tag":698,"props":1831,"children":1832},{},[1833],{"type":52,"tag":74,"props":1834,"children":1836},{"className":1835},[],[1837],{"type":58,"value":945},{"type":52,"tag":61,"props":1839,"children":1841},{"id":1840},"common-issues",[1842],{"type":58,"value":1843},"Common Issues",{"type":52,"tag":366,"props":1845,"children":1847},{"id":1846},"issue-backend-port-is-already-in-use",[1848],{"type":58,"value":1849},"Issue: Backend port is already in use",{"type":52,"tag":68,"props":1851,"children":1852},{},[1853],{"type":52,"tag":1094,"props":1854,"children":1855},{},[1856],{"type":58,"value":1857},"Symptoms:",{"type":52,"tag":106,"props":1859,"children":1860},{},[1861,1873],{"type":52,"tag":110,"props":1862,"children":1863},{},[1864,1866,1872],{"type":58,"value":1865},"Docker Compose fails to bind port ",{"type":52,"tag":74,"props":1867,"children":1869},{"className":1868},[],[1870],{"type":58,"value":1871},"8000",{"type":58,"value":81},{"type":52,"tag":110,"props":1874,"children":1875},{},[1876,1882],{"type":52,"tag":74,"props":1877,"children":1879},{"className":1878},[],[1880],{"type":58,"value":1881},"curl -sf http:\u002F\u002Flocalhost:8000\u002Fhealth",{"type":58,"value":1883}," reaches an unexpected service or fails.",{"type":52,"tag":68,"props":1885,"children":1886},{},[1887],{"type":52,"tag":1094,"props":1888,"children":1889},{},[1890],{"type":58,"value":1891},"Causes:",{"type":52,"tag":106,"props":1893,"children":1894},{},[1895,1900],{"type":52,"tag":110,"props":1896,"children":1897},{},[1898],{"type":58,"value":1899},"Another AI-Q backend or local development server is already running.",{"type":52,"tag":110,"props":1901,"children":1902},{},[1903,1909,1911,1916],{"type":52,"tag":74,"props":1904,"children":1906},{"className":1905},[],[1907],{"type":58,"value":1908},"PORT",{"type":58,"value":1910}," in ",{"type":52,"tag":74,"props":1912,"children":1914},{"className":1913},[],[1915],{"type":58,"value":240},{"type":58,"value":1917}," conflicts with an existing process.",{"type":52,"tag":68,"props":1919,"children":1920},{},[1921],{"type":52,"tag":1094,"props":1922,"children":1923},{},[1924],{"type":58,"value":1925},"Solutions:",{"type":52,"tag":296,"props":1927,"children":1928},{},[1929,1964,1983],{"type":52,"tag":110,"props":1930,"children":1931},{},[1932,1934],{"type":58,"value":1933},"Identify the process:\n",{"type":52,"tag":244,"props":1935,"children":1937},{"className":246,"code":1936,"language":248,"meta":249,"style":249},"lsof -nP -iTCP:8000 -sTCP:LISTEN\n",[1938],{"type":52,"tag":74,"props":1939,"children":1940},{"__ignoreMap":249},[1941],{"type":52,"tag":255,"props":1942,"children":1943},{"class":257,"line":258},[1944,1949,1954,1959],{"type":52,"tag":255,"props":1945,"children":1946},{"style":262},[1947],{"type":58,"value":1948},"lsof",{"type":52,"tag":255,"props":1950,"children":1951},{"style":268},[1952],{"type":58,"value":1953}," -nP",{"type":52,"tag":255,"props":1955,"children":1956},{"style":268},[1957],{"type":58,"value":1958}," -iTCP:8000",{"type":52,"tag":255,"props":1960,"children":1961},{"style":268},[1962],{"type":58,"value":1963}," -sTCP:LISTEN\n",{"type":52,"tag":110,"props":1965,"children":1966},{},[1967,1969,1974,1976,1982],{"type":58,"value":1968},"Either stop the conflicting process with the user's approval or set a different port in ",{"type":52,"tag":74,"props":1970,"children":1972},{"className":1971},[],[1973],{"type":58,"value":240},{"type":58,"value":1975},", such as\n",{"type":52,"tag":74,"props":1977,"children":1979},{"className":1978},[],[1980],{"type":58,"value":1981},"PORT=8100",{"type":58,"value":81},{"type":52,"tag":110,"props":1984,"children":1985},{},[1986,1988],{"type":58,"value":1987},"Restart the selected deployment path and verify:\n",{"type":52,"tag":244,"props":1989,"children":1991},{"className":246,"code":1990,"language":248,"meta":249,"style":249},"curl -sf http:\u002F\u002Flocalhost:8100\u002Fhealth\n",[1992],{"type":52,"tag":74,"props":1993,"children":1994},{"__ignoreMap":249},[1995],{"type":52,"tag":255,"props":1996,"children":1997},{"class":257,"line":258},[1998,2002,2006],{"type":52,"tag":255,"props":1999,"children":2000},{"style":262},[2001],{"type":58,"value":978},{"type":52,"tag":255,"props":2003,"children":2004},{"style":268},[2005],{"type":58,"value":983},{"type":52,"tag":255,"props":2007,"children":2008},{"style":268},[2009],{"type":58,"value":2010}," http:\u002F\u002Flocalhost:8100\u002Fhealth\n",{"type":52,"tag":366,"props":2012,"children":2014},{"id":2013},"issue-required-credentials-are-missing",[2015],{"type":58,"value":2016},"Issue: Required credentials are missing",{"type":52,"tag":68,"props":2018,"children":2019},{},[2020],{"type":52,"tag":1094,"props":2021,"children":2022},{},[2023],{"type":58,"value":1857},{"type":52,"tag":106,"props":2025,"children":2026},{},[2027,2032],{"type":52,"tag":110,"props":2028,"children":2029},{},[2030],{"type":58,"value":2031},"Infrastructure starts, but model-backed chat or research requests fail.",{"type":52,"tag":110,"props":2033,"children":2034},{},[2035],{"type":58,"value":2036},"Logs mention unauthorized, forbidden, invalid key, or missing provider configuration.",{"type":52,"tag":68,"props":2038,"children":2039},{},[2040],{"type":52,"tag":1094,"props":2041,"children":2042},{},[2043],{"type":58,"value":1891},{"type":52,"tag":106,"props":2045,"children":2046},{},[2047,2057],{"type":52,"tag":110,"props":2048,"children":2049},{},[2050,2055],{"type":52,"tag":74,"props":2051,"children":2053},{"className":2052},[],[2054],{"type":58,"value":191},{"type":58,"value":2056}," is missing or empty.",{"type":52,"tag":110,"props":2058,"children":2059},{},[2060],{"type":58,"value":2061},"No supported search provider key is configured for web research.",{"type":52,"tag":68,"props":2063,"children":2064},{},[2065],{"type":52,"tag":1094,"props":2066,"children":2067},{},[2068],{"type":58,"value":1925},{"type":52,"tag":296,"props":2070,"children":2071},{},[2072,2083,2095],{"type":52,"tag":110,"props":2073,"children":2074},{},[2075,2077,2082],{"type":58,"value":2076},"Check presence without printing values by following ",{"type":52,"tag":74,"props":2078,"children":2080},{"className":2079},[],[2081],{"type":58,"value":528},{"type":58,"value":81},{"type":52,"tag":110,"props":2084,"children":2085},{},[2086,2088,2093],{"type":58,"value":2087},"Ask the user to update ",{"type":52,"tag":74,"props":2089,"children":2091},{"className":2090},[],[2092],{"type":58,"value":240},{"type":58,"value":2094},"; do not ask them to paste secrets into chat.",{"type":52,"tag":110,"props":2096,"children":2097},{},[2098,2100,2105],{"type":58,"value":2099},"Rerun ",{"type":52,"tag":74,"props":2101,"children":2103},{"className":2102},[],[2104],{"type":58,"value":894},{"type":58,"value":2106}," after the user updates credentials.",{"type":52,"tag":366,"props":2108,"children":2110},{"id":2109},"issue-backend-is-healthy-but-not-compatible-with-aiq-research",[2111],{"type":58,"value":2112},"Issue: Backend is healthy but not compatible with aiq-research",{"type":52,"tag":68,"props":2114,"children":2115},{},[2116],{"type":52,"tag":1094,"props":2117,"children":2118},{},[2119],{"type":58,"value":1857},{"type":52,"tag":106,"props":2121,"children":2122},{},[2123,2148],{"type":52,"tag":110,"props":2124,"children":2125},{},[2126,2131,2133,2139,2140,2146],{"type":52,"tag":74,"props":2127,"children":2129},{"className":2128},[],[2130],{"type":58,"value":1579},{"type":58,"value":2132}," succeeds, but ",{"type":52,"tag":74,"props":2134,"children":2136},{"className":2135},[],[2137],{"type":58,"value":2138},"\u002Fchat",{"type":58,"value":748},{"type":52,"tag":74,"props":2141,"children":2143},{"className":2142},[],[2144],{"type":58,"value":2145},"\u002Fv1\u002Fjobs\u002Fasync\u002Fagents",{"type":58,"value":2147}," fails.",{"type":52,"tag":110,"props":2149,"children":2150},{},[2151,2156],{"type":52,"tag":74,"props":2152,"children":2154},{"className":2153},[],[2155],{"type":58,"value":79},{"type":58,"value":2157}," reports that async agents are unavailable.",{"type":52,"tag":68,"props":2159,"children":2160},{},[2161],{"type":52,"tag":1094,"props":2162,"children":2163},{},[2164],{"type":58,"value":1891},{"type":52,"tag":106,"props":2166,"children":2167},{},[2168,2173],{"type":52,"tag":110,"props":2169,"children":2170},{},[2171],{"type":58,"value":2172},"The selected config is CLI-only or does not expose the web\u002FAPI backend expected by the skill.",{"type":52,"tag":110,"props":2174,"children":2175},{},[2176,2181,2182,2187],{"type":52,"tag":74,"props":2177,"children":2179},{"className":2178},[],[2180],{"type":58,"value":746},{"type":58,"value":748},{"type":52,"tag":74,"props":2183,"children":2185},{"className":2184},[],[2186],{"type":58,"value":754},{"type":58,"value":2188}," points at the wrong AI-Q config.",{"type":52,"tag":68,"props":2190,"children":2191},{},[2192],{"type":52,"tag":1094,"props":2193,"children":2194},{},[2195],{"type":58,"value":1925},{"type":52,"tag":296,"props":2197,"children":2198},{},[2199,2210,2222],{"type":52,"tag":110,"props":2200,"children":2201},{},[2202,2203,2208],{"type":58,"value":522},{"type":52,"tag":74,"props":2204,"children":2206},{"className":2205},[],[2207],{"type":58,"value":763},{"type":58,"value":2209}," and confirm the selected config is API-enabled.",{"type":52,"tag":110,"props":2211,"children":2212},{},[2213,2215,2221],{"type":58,"value":2214},"For the default Skill backend, use ",{"type":52,"tag":74,"props":2216,"children":2218},{"className":2217},[],[2219],{"type":58,"value":2220},"configs\u002Fconfig_web_default_llamaindex.yml",{"type":58,"value":81},{"type":52,"tag":110,"props":2223,"children":2224},{},[2225,2227,2232],{"type":58,"value":2226},"Restart the backend and rerun ",{"type":52,"tag":74,"props":2228,"children":2230},{"className":2229},[],[2231],{"type":58,"value":894},{"type":58,"value":81},{"type":52,"tag":366,"props":2234,"children":2236},{"id":2235},"issue-docker-cleanup-would-remove-useful-state",[2237],{"type":58,"value":2238},"Issue: Docker cleanup would remove useful state",{"type":52,"tag":68,"props":2240,"children":2241},{},[2242],{"type":52,"tag":1094,"props":2243,"children":2244},{},[2245],{"type":58,"value":1857},{"type":52,"tag":106,"props":2247,"children":2248},{},[2249,2261],{"type":52,"tag":110,"props":2250,"children":2251},{},[2252,2254,2260],{"type":58,"value":2253},"Troubleshooting suggests ",{"type":52,"tag":74,"props":2255,"children":2257},{"className":2256},[],[2258],{"type":58,"value":2259},"docker compose down -v",{"type":58,"value":81},{"type":52,"tag":110,"props":2262,"children":2263},{},[2264],{"type":58,"value":2265},"The user may have local PostgreSQL job or checkpoint data they want to keep.",{"type":52,"tag":68,"props":2267,"children":2268},{},[2269],{"type":52,"tag":1094,"props":2270,"children":2271},{},[2272],{"type":58,"value":1891},{"type":52,"tag":106,"props":2274,"children":2275},{},[2276,2286],{"type":52,"tag":110,"props":2277,"children":2278},{},[2279,2284],{"type":52,"tag":74,"props":2280,"children":2282},{"className":2281},[],[2283],{"type":58,"value":1219},{"type":58,"value":2285}," removes Docker volumes.",{"type":52,"tag":110,"props":2287,"children":2288},{},[2289],{"type":58,"value":2290},"Rebuilds and restarts are often enough for config or image changes.",{"type":52,"tag":68,"props":2292,"children":2293},{},[2294],{"type":52,"tag":1094,"props":2295,"children":2296},{},[2297],{"type":58,"value":1925},{"type":52,"tag":296,"props":2299,"children":2300},{},[2301,2312,2317],{"type":52,"tag":110,"props":2302,"children":2303},{},[2304,2306,2311],{"type":58,"value":2305},"Prefer a normal restart from ",{"type":52,"tag":74,"props":2307,"children":2309},{"className":2308},[],[2310],{"type":58,"value":945},{"type":58,"value":81},{"type":52,"tag":110,"props":2313,"children":2314},{},[2315],{"type":58,"value":2316},"Ask for explicit approval before running volume deletion.",{"type":52,"tag":110,"props":2318,"children":2319},{},[2320],{"type":58,"value":2321},"After cleanup, rerun deployment and validation from the selected route.",{"type":52,"tag":2323,"props":2324,"children":2325},"style",{},[2326],{"type":58,"value":2327},"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":2329,"total":2448},[2330,2348,2364,2376,2396,2418,2436],{"slug":2331,"name":2331,"fn":2332,"description":2333,"org":2334,"tags":2335,"stars":22,"repoUrl":23,"updatedAt":24},"accessibility-and-inclusive-visualization","make data visualizations accessible","Make data visualizations accessible and inclusive. Use when the user needs chart or diagram accessibility guidance, text alternatives for complex visuals, color and contrast review, keyboard support, reduced-motion behavior for animation or parallax, or an accessibility QA workflow for exported figures, UML-like diagrams, and dashboards.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2336,2339,2342,2345],{"name":2337,"slug":2338,"type":15},"Accessibility","accessibility",{"name":2340,"slug":2341,"type":15},"Charts","charts",{"name":2343,"slug":2344,"type":15},"Data Visualization","data-visualization",{"name":2346,"slug":2347,"type":15},"Design","design",{"slug":2349,"name":2349,"fn":2350,"description":2351,"org":2352,"tags":2353,"stars":22,"repoUrl":23,"updatedAt":2363},"agent-browser","automate browser interactions for agents","Browser automation CLI for AI agents. Use when the user needs to interact with websites, verify dev server output, test web apps, navigate pages, fill forms, click buttons, take screenshots, extract data, or automate any browser task. Also triggers when a dev server starts so you can verify it visually.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2354,2357,2360],{"name":2355,"slug":2356,"type":15},"Agents","agents",{"name":2358,"slug":2359,"type":15},"Browser Automation","browser-automation",{"name":2361,"slug":2362,"type":15},"Testing","testing","2026-04-06T18:41:03.44016",{"slug":2365,"name":2365,"fn":2366,"description":2367,"org":2368,"tags":2369,"stars":22,"repoUrl":23,"updatedAt":2375},"agent-browser-verify","verify dev server output with automated browser","Automated browser verification for dev servers. Triggers when a dev server starts to run a visual gut-check with agent-browser — verifies the page loads, checks for console errors, validates key UI elements, and reports pass\u002Ffail before continuing.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2370,2371,2374],{"name":2358,"slug":2359,"type":15},{"name":2372,"slug":2373,"type":15},"Local Development","local-development",{"name":2361,"slug":2362,"type":15},"2026-04-06T18:41:17.526867",{"slug":2377,"name":2377,"fn":2378,"description":2379,"org":2380,"tags":2381,"stars":22,"repoUrl":23,"updatedAt":2395},"agents-sdk","build AI agents on Cloudflare Workers","Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2382,2383,2386,2389,2392],{"name":2355,"slug":2356,"type":15},{"name":2384,"slug":2385,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":2387,"slug":2388,"type":15},"SDK","sdk",{"name":2390,"slug":2391,"type":15},"Serverless","serverless",{"name":2393,"slug":2394,"type":15},"WebSockets","websockets","2026-04-06T18:39:51.717063",{"slug":2397,"name":2397,"fn":2398,"description":2399,"org":2400,"tags":2401,"stars":22,"repoUrl":23,"updatedAt":2417},"ai-elements","build chat UIs with AI Elements","AI Elements component library guidance — pre-built React components for AI interfaces built on shadcn\u002Fui. Use when building chat UIs, message displays, tool call rendering, streaming responses, reasoning panels, or any AI-native interface with the AI SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2402,2405,2408,2411,2414],{"name":2403,"slug":2404,"type":15},"Frontend","frontend",{"name":2406,"slug":2407,"type":15},"React","react",{"name":2409,"slug":2410,"type":15},"shadcn\u002Fui","shadcn-ui",{"name":2412,"slug":2413,"type":15},"UI Components","ui-components",{"name":2415,"slug":2416,"type":15},"Vercel","vercel","2026-04-06T18:40:59.619419",{"slug":2419,"name":2419,"fn":2420,"description":2421,"org":2422,"tags":2423,"stars":22,"repoUrl":23,"updatedAt":2435},"ai-gateway","configure Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2424,2425,2428,2431,2434],{"name":17,"slug":18,"type":15},{"name":2426,"slug":2427,"type":15},"Cost Optimization","cost-optimization",{"name":2429,"slug":2430,"type":15},"LLM","llm",{"name":2432,"slug":2433,"type":15},"Performance","performance",{"name":2415,"slug":2416,"type":15},"2026-04-06T18:40:44.377464",{"slug":2437,"name":2437,"fn":2438,"description":2439,"org":2440,"tags":2441,"stars":22,"repoUrl":23,"updatedAt":2447},"ai-generation-persistence","implement persistence patterns for AI generations","AI generation persistence patterns — unique IDs, addressable URLs, database storage, and cost tracking for every LLM generation",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2442,2443,2446],{"name":2426,"slug":2427,"type":15},{"name":2444,"slug":2445,"type":15},"Database","database",{"name":2429,"slug":2430,"type":15},"2026-04-06T18:41:08.513425",600,{"items":2450,"total":2644},[2451,2472,2495,2512,2528,2543,2562,2574,2588,2601,2613,2628],{"slug":2452,"name":2452,"fn":2453,"description":2454,"org":2455,"tags":2456,"stars":2469,"repoUrl":2470,"updatedAt":2471},"prior-auth-packet-builder","build healthcare prior authorization packets","Build a concise prior authorization packet from local case files and payer policy docs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2457,2460,2463,2466],{"name":2458,"slug":2459,"type":15},"Documents","documents",{"name":2461,"slug":2462,"type":15},"Healthcare","healthcare",{"name":2464,"slug":2465,"type":15},"Insurance","insurance",{"name":2467,"slug":2468,"type":15},"Regulatory Compliance","regulatory-compliance",28169,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python","2026-04-16T05:11:39.180399",{"slug":2473,"name":2473,"fn":2474,"description":2475,"org":2476,"tags":2477,"stars":2492,"repoUrl":2493,"updatedAt":2494},"aspnet-core","build ASP.NET Core web applications","Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development. Use when working on Blazor Web Apps, Razor Pages, MVC, Minimal APIs, controller-based Web APIs, SignalR, gRPC, middleware, dependency injection, configuration, authentication, authorization, testing, performance, deployment, or ASP.NET Core upgrades.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2478,2481,2483,2486,2489],{"name":2479,"slug":2480,"type":15},".NET","dotnet",{"name":2482,"slug":2473,"type":15},"ASP.NET Core",{"name":2484,"slug":2485,"type":15},"Blazor","blazor",{"name":2487,"slug":2488,"type":15},"C#","csharp",{"name":2490,"slug":2491,"type":15},"Web Development","web-development",23787,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fskills","2026-04-12T05:07:02.819491",{"slug":2496,"name":2496,"fn":2497,"description":2498,"org":2499,"tags":2500,"stars":2492,"repoUrl":2493,"updatedAt":2511},"chatgpt-apps","build ChatGPT Apps SDK applications","Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2501,2504,2507,2510],{"name":2502,"slug":2503,"type":15},"Apps SDK","apps-sdk",{"name":2505,"slug":2506,"type":15},"ChatGPT","chatgpt",{"name":2508,"slug":2509,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},"2026-04-12T05:07:05.468097",{"slug":2513,"name":2513,"fn":2514,"description":2515,"org":2516,"tags":2517,"stars":2492,"repoUrl":2493,"updatedAt":2527},"cli-creator","build CLIs from API docs","Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read\u002Fwrite commands, return stable JSON, manage auth, and pair with a companion skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2518,2521,2524],{"name":2519,"slug":2520,"type":15},"API Development","api-development",{"name":2522,"slug":2523,"type":15},"CLI","cli",{"name":2525,"slug":2526,"type":15},"Codex","codex","2026-04-12T05:07:04.132762",{"slug":2529,"name":2529,"fn":2530,"description":2531,"org":2532,"tags":2533,"stars":2492,"repoUrl":2493,"updatedAt":2542},"cloudflare-deploy","deploy projects to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2534,2537,2540,2541],{"name":2535,"slug":2536,"type":15},"Cloudflare","cloudflare",{"name":2538,"slug":2539,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":2384,"slug":2385,"type":15},{"name":13,"slug":14,"type":15},"2026-04-12T05:07:14.275118",{"slug":2544,"name":2544,"fn":2545,"description":2546,"org":2547,"tags":2548,"stars":2492,"repoUrl":2493,"updatedAt":2561},"define-goal","define and set measurable project goals","Help the user define a concrete, measurable goal before starting work, especially when they ask to use the goal tool, create a goal, set an objective, clarify success criteria, or turn a fuzzy intention into a quantitative outcome. Use this skill for goal creation and goal refinement only; it does not manage durable snapshots, decision logs, or long-running execution artifacts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2549,2552,2555,2558],{"name":2550,"slug":2551,"type":15},"Productivity","productivity",{"name":2553,"slug":2554,"type":15},"Project Management","project-management",{"name":2556,"slug":2557,"type":15},"Strategy","strategy",{"name":2559,"slug":2560,"type":15},"Task Management","task-management","2026-05-23T06:17:16.870838",{"slug":2563,"name":2563,"fn":2564,"description":2565,"org":2566,"tags":2567,"stars":2492,"repoUrl":2493,"updatedAt":2573},"figma","translate Figma designs into code","Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2568,2569,2571,2572],{"name":2346,"slug":2347,"type":15},{"name":2570,"slug":2563,"type":15},"Figma",{"name":2403,"slug":2404,"type":15},{"name":2508,"slug":2509,"type":15},"2026-04-12T05:06:47.939943",{"slug":2575,"name":2575,"fn":2576,"description":2577,"org":2578,"tags":2579,"stars":2492,"repoUrl":2493,"updatedAt":2587},"figma-code-connect-components","connect Figma designs to code components","Connects Figma design components to code components using Code Connect mapping tools. Use when user says \"code connect\", \"connect this component to code\", \"map this component\", \"link component to code\", \"create code connect mapping\", or wants to establish mappings between Figma designs and code implementations. For canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2580,2581,2584,2585,2586],{"name":2346,"slug":2347,"type":15},{"name":2582,"slug":2583,"type":15},"Design System","design-system",{"name":2570,"slug":2563,"type":15},{"name":2403,"slug":2404,"type":15},{"name":2412,"slug":2413,"type":15},"2026-05-10T05:59:52.971881",{"slug":2589,"name":2589,"fn":2590,"description":2591,"org":2592,"tags":2593,"stars":2492,"repoUrl":2493,"updatedAt":2600},"figma-create-design-system-rules","generate design system rules from Figma","Generates custom design system rules for the user's codebase. Use when user says \"create design system rules\", \"generate rules for my project\", \"set up design rules\", \"customize design system guidelines\", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2594,2595,2596,2598,2599],{"name":2346,"slug":2347,"type":15},{"name":2582,"slug":2583,"type":15},{"name":1626,"slug":2597,"type":15},"documentation",{"name":2570,"slug":2563,"type":15},{"name":2403,"slug":2404,"type":15},"2026-05-16T06:07:47.821474",{"slug":2602,"name":2602,"fn":2603,"description":2604,"org":2605,"tags":2606,"stars":2492,"repoUrl":2493,"updatedAt":2612},"figma-implement-design","translate Figma designs into application code","Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions \"implement design\", \"generate code\", \"implement component\", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2607,2608,2609,2610,2611],{"name":2346,"slug":2347,"type":15},{"name":2570,"slug":2563,"type":15},{"name":2403,"slug":2404,"type":15},{"name":2412,"slug":2413,"type":15},{"name":2490,"slug":2491,"type":15},"2026-05-16T06:07:40.583615",{"slug":2614,"name":2614,"fn":2615,"description":2616,"org":2617,"tags":2618,"stars":2492,"repoUrl":2493,"updatedAt":2627},"hatch-pet","create animated pets for Codex","Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2619,2622,2623,2626],{"name":2620,"slug":2621,"type":15},"Animation","animation",{"name":2525,"slug":2526,"type":15},{"name":2624,"slug":2625,"type":15},"Creative","creative",{"name":2346,"slug":2347,"type":15},"2026-05-02T05:31:48.48485",{"slug":2629,"name":2629,"fn":2630,"description":2631,"org":2632,"tags":2633,"stars":2492,"repoUrl":2493,"updatedAt":2643},"imagegen","generate and edit raster images","Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG\u002Fvector\u002Fcode-native assets, extending an established icon or logo system, or building the visual directly in HTML\u002FCSS\u002Fcanvas.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2634,2635,2636,2639,2642],{"name":2624,"slug":2625,"type":15},{"name":2346,"slug":2347,"type":15},{"name":2637,"slug":2638,"type":15},"Image Generation","image-generation",{"name":2640,"slug":2641,"type":15},"Images","images",{"name":9,"slug":8,"type":15},"2026-05-15T06:23:24.312127",675]