go-workspace-skill

Installation
SKILL.md

Go Workspace Skill

A workspace config file is the source of truth for repo names, clone URLs, and which repos are Go projects. Run everything through scripts/run.sh; it needs Python 3.8+, git, and go, and the workspace needs no Makefile. Command semantics and exit codes live in references/config.md.

Workflow

  1. Locate the workspace root and config.

    • Inside the root, run scripts/run.sh directly; from a global skill install, pass --root /abs/path/to/workspace.
    • The config is .go-workspace.json, then go-workspace.json, in the root; override with --config /abs/path.json or GO_WORKSPACE_SKILLS_CONFIG.
    • With no config, write one with scripts/run.sh --root /path init-config (--output PATH to place it elsewhere, --force to overwrite), then edit it.
    • After changing repo membership, clone URLs, or Go-project status, edit that config.
  2. Run the action: scripts/run.sh --root /path <action>; put --dry-run before the action to preview commands.

    • sync [repo...]: clone or fast-forward each repo; names must exist in the config.
    • build, test: run across every Go project; they take no repo filter.
    • list-repos, list-projects (--format lines|shell|json): read-only.
    • clean --force: delete repos that hold no local work; skip the rest.
Installs
4
Repository
itamaker/skills
First Seen
Sep 29, 2026