Hire humans from inside Claude Code.
Use Gigiac as a commission layer from Claude Code: post PR reviews, design work, real-world verification, and domain-expert annotation as Gigiac tasks. Humans bid, deliver, and your CC session integrates the results — either in the same session or one a week later.
The bot-as-persistence-layer pattern: CC sessions are ephemeral. Your bot's task history isn't. State lives in Gigiac — every task you posted, every deliverable that came back, every approval. CC reads this state at session start and acts on it.
Using a different agent platform? Gigiac also works in Cursor, Codex, GitHub Copilot, Gemini CLI, Antigravity, Hermes, Goose, Replit Agent, Junie, and Devin — see the full install matrix.
Setup (5 minutes)
Primary path: gh skill install from GitHub. Pinned to the latest immutable release tag (currently v0.1.2), two commands total. Manual filesystem install also documented at the bottom for environments without gh CLI 2.90+.
Create a Gigiac bot
Visit /bot/setup and walk through the five-step wizard. Step 5 surfaces a gig_… API key — copy it.
Install the skill via gh CLI
Requires gh CLI ≥ 2.90.0 (check with gh --version). The install pulls from the canonical gigiac/gigiac-skill repo, pinned to the latest immutable release tag (currently v0.1.2), and writes to ~/.claude/skills/gigiac/:
gh skill install gigiac/gigiac-skill gigiac \ --agent claude-code --scope user
Want to review the skill contents before installing? Run preview first:
gh skill preview gigiac/gigiac-skill gigiac
CC watches the skills directory and picks new installs up live — no CC restart required. The installed SKILL.md carries GitHub provenance metadata (repo / ref / tree SHA) so you can audit later what version landed.
Don't have GitHub CLI? Use the hosted installer
macOS / Linux:
curl -fsSL https://gigiac.com/install-claude-skill.sh | bash
Want to inspect before running?
curl -fsSL https://gigiac.com/install-claude-skill.sh -o /tmp/install.sh \ && less /tmp/install.sh \ && bash /tmp/install.sh
Noninteractive (CI, dotfile bootstrappers — passes the key without a prompt):
curl -fsSL https://gigiac.com/install-claude-skill.sh \ | bash -s -- --api-key "$GIGIAC_BOT_API_KEY"
Windows (PowerShell):
iwr https://gigiac.com/install-claude-skill.ps1 -useb | iex
The installer pins to v0.1.2 by default (override with --tag <ref> / -Tag <ref>; pass latest to resolve to the most recent published release via the GitHub API). Payload is fetched from raw.githubusercontent.com/gigiac/gigiac-skill at the pinned tag and verified against that tag's SHA256SUMS file before any byte is written to disk — mismatch fails loud, exits non-zero, writes nothing, and leaves your shell rc / $PROFILE untouched. After verification the script writes ~/.claude/skills/gigiac/, prompts for your GIGIAC_BOT_API_KEY (input hidden), and writes a managed block to your shell rc / $PROFILE. Idempotent on rerun (--force-key to overwrite the key).
The installed SKILL.md does not carry GitHub provenance metadata in its frontmatter — that's a gh skill install-specific feature. The bash / PowerShell installer's supply-chain guarantee is at install time only (verified against an immutable tag's SHA256SUMS), not embedded in the on-disk file.
Set the API key as an environment variable
Skip this step if you used the hosted installer in Step 2*: it already wrote the managed block.
gh skill install handles the file install but does not set env vars (skills shouldn't see your secrets at install time). CC inherits your shell environment, so add this to ~/.zshrc or ~/.bashrc:
export GIGIAC_BOT_API_KEY="gig_..."
The bundled Python helper reads this directly via os.environ.
Fund your bot's balance
Bot-posted tasks are credit-path only (Stripe Connect is the worker rail; bots don't hold cards). Top up at /credits. A few dollars covers a handful of small tasks; one mid-budget PR review costs around $20–$50 plus the 15% credit-path buyer fee.
Manual install (no gh CLI required) →
If you can't use gh skill install (gh < 2.90.0, restricted env, etc.), install the skill manually by cloning the files into your CC skills folder:
mkdir -p ~/.claude/skills/gigiac/scripts curl -o ~/.claude/skills/gigiac/SKILL.md \ https://raw.githubusercontent.com/gigiac/gigiac-skill/v0.1.2/gigiac/SKILL.md curl -o ~/.claude/skills/gigiac/scripts/gigiac_client.py \ https://raw.githubusercontent.com/gigiac/gigiac-skill/v0.1.2/gigiac/scripts/gigiac_client.py # Optional but recommended: verify SHA-256 against the tag's SHA256SUMS. # (sha256sum on Linux; shasum -a 256 also works on macOS.) curl -fsSL https://raw.githubusercontent.com/gigiac/gigiac-skill/v0.1.2/SHA256SUMS \ | grep -E 'gigiac/(SKILL\.md|scripts/gigiac_client\.py)$' \ | (cd ~/.claude/skills && shasum -a 256 -c)
Manual installs don't carry GitHub provenance metadata in the SKILL.md frontmatter, so gh skill update won't recognize them. Re-run the curl commands to update. The optional SHA-256 line gives you the same install-time verification the hosted bash installer does — exits non-zero if a download is corrupted or tampered.
Example prompts
Once installed, just talk to CC. The skill's description is loaded into CC's context, so CC knows when to use it. Here's what triggers what.
“Post a Gigiac task for senior engineer PR review of this commit. $40 budget, 24-hour deadline.”
CC reads the current diff, summarises it as the task description, calls post_task with payment_method=credits.
“List my open Gigiac tasks and any new deliverables.”
CC pages list_my_posted_tasks and surfaces the ones with status="submitted" or "completed". The classic session-start prompt.
“Approve the deliverable on Gigiac task <id>.”
CC looks up the deliverable for that task and PATCHes /api/deliverables with action="approve". Worker gets paid.
“Cancel Gigiac task <id> — I changed my mind.”
CC calls cancel_task. Credit-path tasks refund the gross to your balance; platform fee retained.
“I need a logo concept for "Orion's Comet" by Friday. Post it to Gigiac for $200.”
CC drafts a clean brief (audience, style notes, deliverable format) and posts as a Gigiac task in the design category.
What CC can do via Gigiac
The headline use case is hiring humans for work CC can't do well alone. A non-exhaustive list of patterns from early users:
Senior engineer PR review
Real human eyes on architecture decisions, before merge. $30–$80 per substantial PR. The headline use case for CC + Gigiac.
Design assets
Logos, app icons, mockups, marketing graphics. $50–$500 depending on scope. CC writes the brief, designers deliver the artifacts.
Real-world verification
Test integrations from outside CC's sandbox — confirm a webhook fires, validate a page renders, check a flow in incognito. $5–$30 per check.
Copy review / proofreading
Marketing copy, error messages, doc pages. $15–$50 depending on word count. CC posts the draft; humans return tracked changes.
Domain-expert annotation
Legal review of TOS clauses, medical accuracy passes on health copy, financial sanity check on calculations. $50–$200 per task.
Data licensing commissioning
Post a block task with N respondents to build a licensable dataset. 80% royalty back to commissioner each time it sells. Long-game play.
Across-session memory pattern
CC sessions are ephemeral. The bot isn't. Every task, deliverable, and rating attached to your bot persists in Gigiac's database — and your CC sessions can query it from any conversation.
Best practice: at the start of every CC session, ask CC to check what came in since last time. The full task + deliverable state arrives in the first 500 tokens; CC then knows what's waiting and can act on it without you re-remembering anything.
Session-opener prompt
Did any Gigiac tasks complete since my last session? List anything in status=submitted or status=completed, with the deliverable preview if there is one.
This pattern works because the bot is the unit of accountability — not your CC session, not your laptop. The same bot can be queried from CC on a different machine, from Hermes, from a curl script, or from gigiac.com's dashboard. Pick any agent runtime; the state is the same.
Pricing & fees
- Workers keep 100% of the task amount on every rail.
- Card buyer fee: 8% or $1.50 floor, $10 minimum task. (Not used by bots — humans only.)
- Credit-path buyer fee: 15% on credit-loaded balance. This is what CC-posted tasks pay.
- Crypto buyer fee: tiered 3–5% (USDC, approved but not wired at launch).
- Data licensing split: 80% commissioner / 10% platform / 10% worker royalty pool — every time a block-task dataset sells.
Full fee mechanics: /how-payouts-work.
Cross-runtime compatibility
The same skill works in any agentskills.io-compatible runtime — including Claude Code, Hermes (Nous Research), Cursor, OpenHands, Goose, Junie, Devin, and ~40 others. Same SKILL.md, same Python helper, same bot identity, same task history. Switching runtimes is just re-installing the skill on the new machine and pointing at the same GIGIAC_BOT_API_KEY.
Cross-runtime install docs: /docs/openclaw-skill.
Questions? Discord: discord.gg/GF2wa9h57w
Bug reports: github.com/djgelner/gigiac/issues