gk-personal

Manage GitKraken CLI workspaces and repository inventory across GitHub and Azure DevOps hosts.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/agents --skill gk-personal-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gk-personal
Source: https://github.com/leonardoacosta/agents/tree/main/skills/gk-personal
Command: npx skills add https://github.com/leonardoacosta/agents --skill gk-personal-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Keeping GitKraken CLI workspaces organized across multiple machines, organizations, and Git providers is error-prone: duplicate cloud workspaces get created, repo identities get confused by name alone, and local clones get mistaken for hosted repos. This Skill provides a disciplined procedure for discovering, grouping, renaming, syncing, and sharing gk workspaces using native CLI state instead of a hand-maintained manifest. ## Core Features & Use Cases - Native inventory discovery: Uses gk workspace list, gk workspace info, and provider repo queries to inspect existing cloud and local workspaces before making any change. - Safe workspace mutations: Applies membership deltas through gk workspace update flags (--add-repos, --remove-repos, --add-teams, --name) while preserving stable workspace IDs and existing sharing. - Multi-context operations: Handles personal GitHub, a side-business organization, and employer Azure DevOps contexts, including remote inspection of a second machine (bb-mac) over SSH. - Use Case: You want to gather all Brown work repos from your Mac into the existing Brown cloud workspace. The Skill verifies access on both hosts, resolves provider-qualified repo identities, states the membership delta, applies it, and re-syncs to confirm the result. ## Quick Start Ask the agent to list my GitKraken cloud workspaces and move the tavern-ledger repo into the Priceless Development workspace, then verify the change.

Frequently Asked Questions about gk-personal

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

FAQPage Schema
How do I list and inspect GitKraken CLI workspaces?

Run `gk workspace list --output json` to see IDs, names, types, and counts, adding `--sync` for current cloud membership. Then load a single workspace with `gk workspace info "<name>" --output json` to view its repositories and local paths.

How do I add or remove repos from a gk workspace?

Use `gk workspace update "<name>"` with `--add-repos` or `--remove-repos`, checking `--help` for accepted repo identifiers. State the intended membership delta first, then re-sync and verify workspace IDs and exact membership afterward.

Can I convert a local gk workspace to a cloud workspace?

Yes, using the `--cloud` flag, but only after verifying no equivalent cloud workspace already exists and confirming the provider constraints and target organization. Converting blindly creates duplicate cloud collections that other machines cannot reconcile.

Why does a repo appear missing from my gk workspace?

An empty local path means the repo is unmapped on this machine, not deleted, and repo names alone are not unique across providers. Resolve identity by provider, owner, project, and repo ID before concluding anything is missing.

Should I edit gk's internal JSON files to fix workspace state?

No. Files like `cloudWorkspaces.json` and `repoMapping.json` under `~/.local/share/gk` are implementation details, not a stable schema. Prefer CLI output and never edit internal stores to simulate a cloud change.