Use for everyday gogh CLI operations, including auth/roots/config plus overlay, script, hook, and extra workflows.
Use this skill when a user asks for gogh CLI usage or automation flows (overlay/script/hook/extra). Keep output concise and prefer showing the exact command with minimal explanation.
Create a new repo: gogh create <host/owner/repo> then gogh clone <host/owner/repo>
Find existing repo (local): gogh list [--format ...] [--primary]
Find existing repo (remote): gogh repos [--limit N] [--privacy ...]
Show repo for current dir: gogh cwd
Help: gogh help or gogh <command> --help
List local repos: gogh list
Show repo for current dir: gogh cwd
Clone: gogh clone <host/owner/repo> or full URL
Create: gogh create <host/owner/repo>
Fork: gogh fork <owner/repo> --to <target-owner>
Delete: gogh delete <host/owner/repo>
List remote repos: gogh repos
gogh auth login <host>gogh auth listgogh auth logout <host> <owner>gogh config showgogh config set-default-host <host>, gogh config set-default-owner <host> <owner>gogh config migrategogh roots listgogh roots add <path> [--primary]gogh roots remove <path>gogh roots set-primary <path>gogh bundle dump [-f <file>]gogh bundle restore [-f <file>] [--dry-run]Overlays are file templates applied into repos.
gogh overlay add --name <name> --path <rel/path> --file <src>gogh overlay show <id>gogh overlay listgogh overlay update <id> [--name ...] [--path ...] [--file ...]gogh overlay remove <id>gogh overlay apply <id> <repo>Scripts are Lua snippets executed inside repo directories.
gogh script add --name <name> --file <script.lua>gogh script create --name <name>gogh script listgogh script show <id>gogh script edit <id>gogh script update <id> --file <script.lua>gogh script remove <id>gogh script invoke <id> <repo>gogh script invoke-instant <repo>Lua globals include gogh.repo and gogh.hook (when invoked by hook).
Hooks trigger on repo events and run overlays or scripts.
Events: post-clone, post-fork, post-create.
gogh hook add --name <name> --repo-pattern <glob> --event post-clone --overlay <overlay-id>gogh hook add --name <name> --repo-pattern <glob> --event post-clone --script <script-id>gogh hook listgogh hook show <id>gogh hook update <id> [--name ...] [--repo-pattern ...] [--event ...] [--overlay <id>|--script <id>]gogh hook remove <id>gogh hook invoke <id> <repo>Extras bundle overlays and hooks for reuse.
gogh extra save --name <name> --repo <repo>gogh extra create --name <name> --source <repo> [--overlay <id> ...] [--hook <id> ...]gogh extra listgogh extra show <id>gogh extra apply --name <name> [--repo <repo>]gogh extra remove <id>gogh <command> --help for exact flags in the installed version.