Workspace skeleton

February 7, 2026 · View on GitHub

Agentbox ships a built-in workspace skeleton intended to jump-start new repositories with:

  • A baseline .github/ folder (CI, release, Docker publishing, cleanup)
  • Stack-specific Copilot instruction files under .github/instructions/
  • A copilot-instructions.md tuned for “use the Makefile” workflows
  • A template Makefile
  • SKILL.md files under .github/skills/ that document the intended conventions

Where it lives in the container

The skeleton is copied into:

  • /home/agent/workspace-skel/

How to initialize a new workspace

From inside the container:

make init-workspace

This copies /home/agent/workspace-skel/ into /workspace/ without overwriting existing files.

What gets copied

  • Makefile
  • .github/copilot-instructions.md
  • .github/workflows/ (CI, release, Docker publish, cleanup)
  • .github/instructions/ (stack-specific Copilot instructions)
  • .github/skills/ (skill descriptions)

Notes

  • The workflows are intentionally generic and expect projects to provide meaningful make check (or make lint + make test) targets.
  • The skeleton Makefile includes optional Docker image build/publish helpers (make docker-build, make dual-tag).
  • Docker publishing workflows are geared towards pushing to GHCR on tags v*.