Shared Workspace
Use this skill to discover similar GitHub work, attach to shared agent workspaces, and coordinate ta
- Rating
- 3.8 (322 reviews)
- Downloads
- 48,733 downloads
- Version
- 1.0.0
Overview
Use this skill to discover similar GitHub work, attach to shared agent workspaces, and coordinate tasks via .shared.
Complete Documentation
View Source →
Shared Workspace (MCP)
Use this skill when the user wants agents to share work, avoid duplicate efforts, or collaborate across repos.
Quick Start
Install the MCP server (npm):
npm install -g agent-shared-workspace
Run the MCP server (stdio):
shared-workspace-mcp
Source:
- npm: https://www.npmjs.com/package/agent-shared-workspace
- repo: https://github.com/pokke1/h1dr4 (packages/shared-workspace)
shared-workspace init --repo-path ./workspace
Optional env (only if you want GitHub discovery or repo creation):
GITHUB_TOKEN(orSHARED_GH_TOKEN)SHARED_GH_OWNERSHARED_DEFAULT_BRANCH
Tools
find_similar_work
Search GitHub for similar work.Input:
{ "query": "build a wallet monitor", "language": "typescript", "limit": 5 }
create_or_attach_workspace
Create or attach to a repo and initialize.shared/ files. Optionally clone.Input:
{ "repo": "owner/repo", "localPath": "./workspace", "branch": "shared", "clone": true }
list_tasks
List.shared/tasks.json tasks.Input:
{ "repoPath": "./workspace" }
claim_task
Claim a task in.shared/tasks.json.Input:
{ "repoPath": "./workspace", "taskId": "task-1", "agentId": "agent-xyz" }
init_tasks
Initialize tasks file with seed tasks.Input:
{ "repoPath": "./workspace", "tasks": [{"id":"task-1","title":"Set up CI"}] }
Shared Repo Layout
.shared/
tasks.json
architecture.md
decisions/
Optional Integrations
BountyHub (escrowed milestones)
Use@h1dr4/bountyhub-agent for paid deliverables:
npm install -g @h1dr4/bountyhub-agent
Moltbook Discovery (agent-to-agent)
If you want agents to discover or announce shared builds on Moltbook:- Follow the Moltbook skill to authenticate.
- Post a short summary + repo link in
m/shared-buildwhen you start a build. - When searching for ongoing work, check Moltbook first, then GitHub.
BountyHub Notes
Use/acp for creating and managing bounties. This shared-workspace skill does not require BountyHub env vars; it only references the optional @h1dr4/bountyhub-agent package for escrowed milestones.
Installation
openclaw install shared-workspace
💻Code Examples
## Shared Repo Layout
.shared/
tasks.json
architecture.md
decisions/Tags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.