{
  "markdown": "# Blaxel Skills\n\nAgent skills for building and deploying AI workloads on Blaxel.\n\n## Onboarder prompt package\n\nControlplane consumes the current onboarding prompt package from this repo's\nprotected `main` branch. That branch is the reviewed release channel for\nonboarding instructions, so prompt-only fixes publish without a controlplane\nrepin. The prompt's install/update command likewise installs the latest skills\nfrom `main` with `--all`.\n\nMerging to `main` changes the prompt and commands shown by the hosted dashboard.\nTreat changes under `prompts/onboarder/v1/` as code: review them, keep the Verify\nworkflow green, and run the isolated install/list smoke test before publishing.\nManifest SHA-256 hashes bind every markdown file to one reviewed package\nversion; a mixed or stale fetch fails closed. Package releases use exact\n`major.minor.patch` versions (no prerelease or build suffixes). Controlplane\nretains a bundled fallback for package-fetch failure or an incompatible/retired\nremote contract.\n\nControlplane's schema-v1 remote-contract gate requires the exact marker\n`Dashboard launch authorizes this bounded Blaxel bootstrap now` and rejects\nretired setup-confirmation contracts. Keep that marker and the bundled fallback\nsemantically aligned whenever the onboarding contract changes.\n\nCurrent package (0.12.0):\n\n- Manifest: [`prompts/onboarder/v1/manifest.json`](prompts/onboarder/v1/manifest.json)\n- Base prompt: [`prompts/onboarder/v1/prompt.md`](prompts/onboarder/v1/prompt.md)\n- Agent package: [`prompts/onboarder/v1/agent-package.md`](prompts/onboarder/v1/agent-package.md)\n- Supplements: [`prompts/onboarder/v1/supplements/`](prompts/onboarder/v1/supplements/)\n\n### Version history\n\n- `0.12.0`: makes protected `main` the dashboard release channel, adds per-file integrity checks for atomic package loading, fixes fresh-environment skill verification, and adds a real isolated install/list CI smoke test.\n- `0.11.0`: makes dashboard launch informed consent for bounded end-to-end setup, adds the approved product sections to every full payload, and hardens project/path, proof, browser-gate, approval-boundary, and filesystem evaluation.\n- `0.10.0`: aligned the package with the dashboard fallback, latest-skill installation, and the multi-agent evaluation harness.\n\nVerify prompt and evaluator changes before opening a PR:\n\n```shell\nnode --test scripts/onboarder-harness/*.test.mjs\nnode scripts/verify-onboarder-prompt.mjs\nnode scripts/verify-onboarder-skill-commands.mjs\n```\n\nServe the prompt package locally with CORS for controlplane preview iteration:\n\n```shell\nnode scripts/serve-onboarder-prompt.mjs --port 8767\n```\n\nRun a bounded-setup eval plan against installed local tools:\n\n```shell\nnode scripts/onboarder-real-eval.mjs --plan --agent codex --profile local-no-auth --phase setup --vector all\n```\n\nThe harness contract lives in `scripts/onboarder-harness/contract.mjs`. It keeps\nthe scenario vectors, local profiles, headless agent adapters, desktop targets,\nand public-repo hygiene file list in one place. The deterministic evaluator also\nchecks project/path specificity, exact setup proof or an honest browser/blocker\ngate, under-12-line plain-language responses, every task-specific approval\nboundary, no pasted-secret request, and an unchanged project filesystem.\n\nUseful local profiles:\n\n- `local-no-auth`: isolated home with Blaxel auth env removed; setup may reach the secure browser-approval gate.\n- `local-env-auth`: isolated home using `BL_WORKSPACE` and `BL_API_KEY`.\n- `local-missing-bl`: hides the `bl` command to evaluate automatic installation and version proof.\n- `local-missing-skills`: starts without visible global skills to evaluate automatic installation and list proof.\n- `local-outdated-bl`: records whether the observed `bl version` reports an upgrade for setup to apply.\n\nHeadless adapters are built in for Codex CLI, Claude Code, and Cursor Agent.\nTo execute a real eval, add `--run` and the explicit live-run acknowledgement\nprinted by the plan. A real run may call a model, install/update Blaxel tools in\nan isolated home, and open secure browser login. The generic eval prompt does\nnot authorize project writes or Blaxel resource creation.\n\nPrepare the desktop GUI eval packet for the full manifest payload:\n\n```shell\nnode scripts/onboarder-desktop-eval.mjs --target all --vector all --phase setup\n```\n\nThis creates real temporary project workspaces plus full-package prompts for\nCursor Composer 2.5 and Claude Desktop Sonnet 4.6. Use the generated `RUNBOOK.md`\nand `scorecard.md` while driving the apps with Computer Use. Controlplane's\ncompact Cursor deeplink is a separate payload; its content parity and URL-length\ngate are verified by the controlplane onboarder tests, not by this desktop packet.\n\nCheck or refresh global Blaxel skills:\n\n```shell\nnpx -y skills list -g --json\nnpx -y skills add blaxel-ai/agent-skills -g --all\n```\n\n## Installation\n\n### npx skills\n```shell\nnpx -y skills add blaxel-ai/agent-skills -g --all\n```\n\n### Claude Code plugin\n```shell\nclaude plugin marketplace add blaxel-ai/agent-skills\nclaude plugin install blaxel\n```\nInstalls both the `blaxel-sdk` and `blaxel-cli` skills.\n\n### Codex plugin\n```shell\ncodex plugin marketplace add blaxel-ai/agent-skills\ncodex plugin add blaxel@blaxel\n```\nInstalls both the `blaxel-sdk` and `blaxel-cli` skills.\n",
  "bytes": 5337,
  "sha": "e221e1adef0ce178ec5eff2269da4a6bd2ffa6f041553936b05126e1eb972087",
  "repo_slug": "blaxel-ai/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_blaxel_ai_agent_skills_blaxel_f1c87499/readme"
}