Agent skill

Cg Worker

by Intelligent-Internet in Intelligent-Internet/CommonGround

A skill your agent uses when deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local cg worker command namespace, including claim acquisition, renewal…

Apache-2.0Auto-check passed

Install Cg Worker

skills CLI

$ npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Intelligent-Internet/CommonGround cg-worker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Intelligent-Internet/CommonGround.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cg-worker .claude/skills/cg-worker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "cg-worker" agent skill from https://github.com/Intelligent-Internet/CommonGround/tree/main/.agents/skills/cg-worker into .claude/skills/cg-worker/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cg-worker", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Intelligent-Internet/CommonGround/tree/main/.agents/skills/cg-worker

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Intelligent-Internet/CommonGround cg-worker --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Intelligent-Internet/CommonGround.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/cg-worker .agents/skills/cg-worker && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "cg-worker" agent skill from https://github.com/Intelligent-Internet/CommonGround/tree/main/.agents/skills/cg-worker into .agents/skills/cg-worker/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cg-worker", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Intelligent-Internet/CommonGround cg-worker --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Intelligent-Internet/CommonGround.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/cg-worker .cursor/skills/cg-worker && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "cg-worker" agent skill from https://github.com/Intelligent-Internet/CommonGround/tree/main/.agents/skills/cg-worker into .cursor/skills/cg-worker/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cg-worker", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Intelligent-Internet/CommonGround.git --path .agents/skills/cg-worker

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Intelligent-Internet/CommonGround cg-worker --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Intelligent-Internet/CommonGround.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/cg-worker .gemini/skills/cg-worker && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "cg-worker" agent skill from https://github.com/Intelligent-Internet/CommonGround/tree/main/.agents/skills/cg-worker into .gemini/skills/cg-worker/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cg-worker", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Intelligent-Internet/CommonGround cg-worker

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Intelligent-Internet/CommonGround.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/cg-worker .github/skills/cg-worker && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "cg-worker" agent skill from https://github.com/Intelligent-Internet/CommonGround/tree/main/.agents/skills/cg-worker into .github/skills/cg-worker/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cg-worker", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Intelligent-Internet/CommonGround cg-worker --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Intelligent-Internet/CommonGround.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/cg-worker .opencode/skills/cg-worker && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "cg-worker" agent skill from https://github.com/Intelligent-Internet/CommonGround/tree/main/.agents/skills/cg-worker into .opencode/skills/cg-worker/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cg-worker", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: cg-worker
GitHub stars: 153
Token cost: ~489 tokens
SKILL.md length: 133 words
Files: 1
Skills in repo: 1
Repo updated: May 20, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

A skill your agent uses when deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local cg worker command namespace, including claim acquisition, renewal…

Deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local cg worker command namespace
SKILL.md covers Rules and Commands
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
Including claim acquisition

What it does

Cg Worker is an agent skill from Intelligent-Internet/CommonGround. Use when deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local cg worker command namespace, including claim acquisition, renewal, progress append, terminal finish, child dispatch, and suspend flows.

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: From isolated agents to shared work. The licence is Apache-2.0.

When your agent uses it

Deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local cg worker command namespace
Including claim acquisition
Progress append
Terminal finish

Example prompts

“/cg-worker”

What it can do on your machine

Read from SKILL.md and the folder at commit 10b50dd. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cg Worker loads about 489 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 133 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~64
When it runs · the whole SKILL.md, loaded when a task matches: ~489

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Intelligent-Internet/CommonGround at commit 10b50dd, republished under its Apache-2.0 licence (© Intelligent-Internet). 133 words, ~489 tokens.

Download SKILL.mdSave it as .claude/skills/cg-worker/SKILL.md (or your agent's skills folder).

name: cg-worker
description: Use when deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local `cg worker` command namespace, including claim acquisition, renewal, progress append, terminal finish, child dispatch, and suspend flows.
metadata.short-description: Use CommonGround worker lifecycle via `cg worker`

CG Worker CLI

Use cg worker for deterministic worker and companion lifecycle operations. Do not use curl for these flows when cg worker covers the operation.

Rules

Use cg worker claim next to acquire work.
When automation needs a reusable claim token file, pass --claim-out-file.
--claim-file accepts either a bare claim JSON object or a full CLI envelope containing result.claim.
Use cg worker claim renew while the claim remains active.
Use cg worker claim append for progress records.
Use cg worker claim finish for terminal close.
Use cg worker claim suspend when the turn must pause for approval, orchestration, or external input.
Use cg worker claim dispatch-child to dispatch a child turn from an active parent claim.

Commands

Claim work and persist the claim token:

bash

cg worker claim next \
  --project-id demo \
  --agent-id worker \
  --claim-out-file /tmp/cg-claim.json

Renew and progress:

bash

cg worker claim renew --claim-file /tmp/cg-claim.json
cg worker claim append --claim-file /tmp/cg-claim.json --payload-file /tmp/progress.json --role progress

Finish, suspend, and child dispatch:

bash

cg worker claim finish --claim-file /tmp/cg-claim.json --outcome succeeded --payload-file /tmp/final.json
cg worker claim suspend --claim-file /tmp/cg-claim.json --reason await_child --note "waiting on child"

cg worker claim dispatch-child \
  --claim-file /tmp/cg-claim.json \
  --requested-by worker \
  --target-agent codex \
  --payload-file /tmp/child-bootstrap.json \
  --dispatch-key child-123

Files

Just SKILL.md in .agents/skills/cg-worker of Intelligent-Internet/CommonGround.

Open the folder on GitHubat commit 10b50dd

Compare with similar skills

Cg Worker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cg Worker compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Cg Worker this skillIntelligent-Internet/CommonGround	153	—	~489	Automated safety check: Pass	Apache-2.0	4 mo ago
Executealirezarezvani/claude-skills	28k	—	~831	Automated safety check: Pass	MIT	1 mo ago
Debugging Executionsn8n-io/n8n	207k	—	~2.6k	Automated safety check: Pass	Custom licence	today
Worker Visualizernexu-io/open-design	100k	—	~998	Automated safety check: Pass	Apache-2.0	today
Agent Worker Specialistruvnet/ruflo	74k	2 repos	~1.4k	Automated safety check: Pass	MIT	today
Loop Workerruvnet/ruflo	74k	—	~297	Automated safety check: Pass	MIT	today

Similar skills

Execute
alirezarezvani/claude-skills
/cs:execute <decision — Generate a 90-day execution plan with weekly milestones, DRIs, and check-in cadence from an approved decision.
28k GitHub stars~831 tokensUpdated 1 mo ago
Product & Project ManagementAuto-check passed
Debugging Executions
n8n-io/n8n
Official
Debug failed or wrong-output workflow executions using executions tools.
207k GitHub stars~2.6k tokensUpdated today
DevelopmentAuto-check passed
Worker Visualizer
nexu-io/open-design
A real-time data/particle/simulation visualizer whose heavy compute runs in a Web Worker (off the main thread), optionally sharing memory with the UI via SharedArrayBuffer, and renders to a canvas…
100k GitHub stars~998 tokensUpdated today
Auto-check passed
Agent Worker Specialist
ruvnet/ruflo
Agent skill for worker-specialist - invoke with $agent-worker-specialist
74k GitHub starsUsed in 2 repos~1.4k tokens
Auto-check passed
Loop Worker
ruvnet/ruflo
Run Ruflo background workers using Claude Code native /loop scheduling
74k GitHub stars~297 tokensUpdated today
Productivity & AutomationAuto-check passed
Ulw Execute
code-yeongyu/oh-my-openagent
Executes a written ulw-plan work plan with Boulder state, evidence ledger, worktree discipline, and parallel subagents.
70k GitHub stars~6.3k tokensUpdated today
Agent WorkflowsAuto-check passed

Questions about Cg Worker

What does Cg Worker do?

A skill your agent uses when deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local cg worker command namespace, including claim acquisition, renewal…. Cg Worker is an agent skill from Intelligent-Internet/CommonGround. Use when deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local cg worker command namespace, including claim acquisition, renewal, progress append, terminal finish, child dispatch, and suspend flows.

When should I use Cg Worker?

Cg Worker fits situations like: deterministic runtime code needs to execute CommonGround worker lifecycle steps through the local cg worker command namespace; including claim acquisition; progress append; terminal finish.

How do I install Cg Worker in Claude Code?

Run `npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a claude-code`. Or copy the skill folder (.agents/skills/cg-worker in Intelligent-Internet/CommonGround) into .claude/skills/cg-worker in your project. Claude Code loads it when a task matches its description.

How do I install Cg Worker in Codex?

Run `npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a codex`. Or copy the skill folder (.agents/skills/cg-worker in Intelligent-Internet/CommonGround) into .agents/skills/cg-worker in your project. Codex loads it when a task matches its description.

Can I use Cg Worker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Intelligent-Internet/CommonGround --skill cg-worker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cg-worker, .gemini/skills/cg-worker, .github/skills/cg-worker and .opencode/skills/cg-worker in your project.

What does Cg Worker need to run?

SKILL.md names no scripts, command-line tools or credentials: Cg Worker is instructions for the agent only.

Does Cg Worker access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cg Worker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cg Worker use?

Cg Worker is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cg Worker use?

About 489 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cg Worker?

Skills that share tags, products or a category with Cg Worker: Execute (alirezarezvani/claude-skills, 28k stars), Debugging Executions (n8n-io/n8n, 207k stars), Worker Visualizer (nexu-io/open-design, 100k stars) and Agent Worker Specialist (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cg Worker?

Intelligent-Internet (a GitHub organization) maintains it in Intelligent-Internet/CommonGround, which has 153 GitHub stars. The repository was last updated on May 20, 2026.

Source: Intelligent-Internet/CommonGround on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Cg Worker

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

CG Worker CLI

Rules

Commands

Files

Compare with similar skills

Similar skills

Execute

Debugging Executions

Worker Visualizer

Agent Worker Specialist

Loop Worker

Ulw Execute

Questions about Cg Worker