hdresearch/reef/app-deployment
Claude Code and agent skill by hdresearch/reef
- community
Checking that the SKILL.md file is still in the repository.
Use when implementing and exposing a product/application service or UI that should run outside Reef root. Choose child/resource VM placement, stand up the app, and report how to reach it.
Install
npx vskill@latest install hdresearch/reef/app-deploymentSKILL.md
The same SKILL.md was published earlier as hdresearch/reef/app-deployment.
App Deployment
Use this skill when the task is to build, run, or expose a product/application service or UI that is not clearly part of Reef's own operator control plane.
Default Placement
For repo implementation requests, default deployment target is outside Reef root.
Typical choices:
agent_vmfor a cohesive implementation slice that owns its own runtime setuplieutenantfor a persistent coordinator that owns an operational systemresource_vmfor stateful support infrastructure, raw environments, databases, or long-lived app hosting
Do not treat Reef root as the default home for the product you are building.
Deployment Target Decision
Before you stand anything up, decide explicitly:
- Is this a Reef control-plane feature?
- Reef panel
- Reef API/service module
- operator-facing Reef UI
- Or is it product/application infrastructure?
- app UI
- API server
- dashboard
- data pipeline runtime
- webhook sink
- background worker
Default to product/application infrastructure on a child VM unless the answer to (1) is clearly yes.
Recommended Flow
- Orient on the repo
- Decide ownership and deployment target
- Spawn the right child or infrastructure VM
- Clone or prepare the repo there
- Install only what that target needs
- Run, validate, and expose the app there
- Report back:
- VM name and ID
- repo path
- ports or URLs
- processes
- how to restart or inspect it
- whether it should persist
Root's Role
Root should usually:
- prepare and understand the repo
- choose target placement
- delegate implementation/deployment
- supervise and integrate
Root should not usually:
- become the app host
- mutate or restart Reef services for product work
- mix control-plane changes with ordinary app deployment
Ownership Discipline
If a child owns deployment, root should not quietly redo that deployment itself.
If the current execution path changes:
- steer the child
- replace the child
- or reclaim ownership explicitly
Then report the change so scheduled checks, receipts, and supervision state remain truthful.
What Done Must Include
When reporting a deployed app or service, include:
- deployment target type (
agent_vm,lieutenant,resource_vm) - VM name and ID
- repo path
- branch or commit if relevant
- ports, URLs, and health endpoints
- start/restart commands if relevant
- tests or smoke checks run
- whether the target remains alive/idle or is stopping
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/app-deployment/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/hdresearch/reef/app-deployment)