build-workspace

Scaffolds Claude or Gemini workspaces with base image, AI CLI, and plugin layer.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/sun2admin/builder-project --skill build-workspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-workspace
Source: https://github.com/sun2admin/builder-project/tree/main/.claude/skills/build-workspace
Command: npx skills add https://github.com/sun2admin/builder-project --skill build-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool automates the end-to-end provisioning of Claude or Gemini workspaces, replacing manual setup tasks with a repeatable, config-driven process.

Core Features & Use Cases

  • Automated provisioning: select and apply a base image, AI install-layer, and plugin layer to create a ready-to-run development environment.
  • Project integration: optionally discover and validate GitHub projects, seed memory, and establish a sync workflow for memory persistence.
  • Lifecycle start: initialize the workspace, validate project structure, and launch Claude with safe permissions.

Quick Start

Run /build-workspace [--dry-run] to scaffold a new Claude or Gemini workspace with base image, AI install-layer, plugin layer, and optional GitHub project discovery.

Frequently Asked Questions about build-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate workspace provisioning for Claude or Gemini development environments?

Automated workspace provisioning for Claude or Gemini uses a config-driven process to select a base image, AI CLI, and plugin layer, creating a ready-to-run environment. This replaces manual setup by scaffolding the entire workspace automatically.

What is memory seeding and how does it work with GitHub project discovery?

Memory seeding initializes persistent context for your AI workspace by validating GitHub projects and establishing a sync workflow. It deploys a version control integration in /workspace to maintain memory continuity across sessions.

Do I need GitHub CLI to scaffold an AI workspace with this automated approach?

Yes, you need the GitHub CLI (gh) to query and discover GitHub projects during workspace scaffolding. You also need access to GHCR images to validate or build the base image layer before initializing the environment.

Can I test workspace provisioning configurations before applying them?

Yes, you can run the provisioning command with a dry-run flag to test workspace scaffolding configurations. This allows you to validate the selected base image, AI install-layer, and plugin layer without making actual changes to your environment.

What's the best way to initialize a development environment with safe permissions for Claude?

The best way to initialize a Claude environment with safe permissions is to run the init-workspace.sh script after scaffolding. This validates the project structure, completes memory seeding, and launches Claude with configured safe permissions.

Does automated workspace setup support both Claude and Gemini CLI layers?

Yes, automated workspace setup supports both Claude and Gemini by allowing you to select the specific AI CLI install-layer during provisioning. The scaffolding process applies the chosen CLI layer along with the base image and plugins.