robertderose/dstack

dstack-beads-setup-project

Install and validate dStack formula source, with explicit isolated legacy repair when requested.

Installation

$ npx skills add robertderose/dstack --skill dstack-beads-setup-project

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from robertderose/dstack · top by installs.

npx skills add robertderose/dstack

Browse all from robertderose/dstack

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

License LICENSE
Default branch dev
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,458 B
  • docs SUMMARY.md 130 B

History

  1. First recorded snapshot · 1 installs

SKILL.md

Setup project

Invoking this command authorizes Beads initialization in the current Git repository.

Run the read-only plan, review its exact preconditions and changes, then apply from freshly recomputed authority state:

"{baseDir}/../../bin/dstack" setup plan --root . --init
"{baseDir}/../../bin/dstack" setup apply --root . --init --plan-digest "<plan_sha256>"

Replace <plan_sha256> with the digest emitted by the reviewed plan. The plan contains one strict dstack.setup-plan/v4 mutation object; review its controller/runtime authority, initialization, Beads, verified template deletion, filesystem, formula, Git-index, and navigation/reference records rather than relying on display summaries. Append --force to both commands only when the user explicitly supplied it. Apply recomputes the same object once and fails closed if its digest or any source/precondition changed. When --force was requested, apply first migrates mechanically identifiable legacy book content into docs/src, then completes the non-destructive documentation foundation/navigation, performs the remaining isolated compatibility repair, and finally runs strict documentation validation. Do not invoke repair a second time.

Finally run the setup doctor once with the explicitly selected delivery profile (use merge for local/direct delivery or pr when GitHub PR delivery is intended):

"{baseDir}/../../bin/dstack" setup doctor --root . --delivery-mode merge

The mode is required; never infer it from remotes. Merge mode does not require a remote, GitHub, or gh. PR mode additionally checks a usable GitHub target remote, GitHub CLI authentication, and native Beads gh:pr gate capability. Report the selected mode and every diagnostic.

Report formula install/validation, Beads version, canonical mdBook foundation creation/validation, the local interaction-log policy, missing historical feature reconciliations, applied documentation moves/reference rewrites, and other compatibility repair. Report ambiguous Markdown that cannot be placed in the book mechanically; leave it for user/agent judgment. Do not commit automatically. Ask the user to review and commit the setup boundary before starting feature work. Normal feature commands do not run setup doctor or legacy repair.