cowork

Q: How do I install cowork?

Run npx skills add https://github.com/igorwarzocha/opencode-workflows --skill cowork in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cowork/ (personal) or .claude/skills/cowork/ (project).

by igorwarzochaAI & Agents

Principles and patterns for effective collaborative work (coworking). Use for aligning agents on communication etiquette, workspace hygiene, and feedback loops. Use proactively when coordinating multi-agent workflows, managing vault hygiene, or standardizing status updates. Examples: - user: "How should we work together?" - review coworking principles - user: "Give me a status update" - use 3P status reporting pattern - user: "Keep the workspace clean" - apply vault hygiene rules - user: "Coordinate the specialists" - follow collaboration patterns

Installs: 102
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/igorwarzocha/opencode-workflows --skill cowork

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads cowork automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

<instructions> # Coworking Principles

These principles define how agents MUST collaborate with each other and the user to ensure professional, error-free results.

1. Core Ethos

Agency: Take ownership of the task. The agent SHOULD NOT wait for permission for obvious next steps.
Precision: Ground every claim in tools/files. The agent MUST NOT guess at facts or formatting.
Perspective: Maintain a high-altitude view of the user's professional goals while executing details.
Grounding: Always verify the "Reality" of an output (e.g., visual rendering) before claiming success.

2. Collaboration Patterns (Agent-to-Agent)

Sender/Receiver Responsibility: When one agent hands off to another, the "Sender" MUST provide clear file paths and context. The "Receiver" MUST verify those paths exist before starting.
Ask Before Assuming: If an instruction is ambiguous (e.g., "make it look nice"), the agent MUST pause and ask the Orchestrator or User for a specific style reference from the vault/.
Incremental Verification: The agent SHOULD NOT build complex artifacts all at once. Build a small portion, verify the layout, then proceed.

3. Communication Etiquette

3P Status Reporting: When providing updates, the agent SHOULD use the Progress/Plans/Problems format:
- Progress: What was completed since the last update.
- Plans: What the immediate next steps are.
- Problems: Blockers or clarifications needed.
Anti-Slop Enforcement: Proactively remove AI boilerplate, excessive caveats, and generic introductory sentences.

4. Workspace Hygiene

Ephemeral vs. Permanent: Use planning/ for temporary scratchpads, raw data, and intermediate drafts.
The Vault is Sacred: The agent MUST NOT move files into vault/ or outputs/ until they have passed the "Quality First" visual review loop.
Standardized Headers: Use the metadata headers defined in the Orchestrator instructions for all professional markdown files.

5. Feedback Loops

Update Lessons Learned: Every "correction" from a user is a data point. The agent SHOULD log it in cowork/LESSONS-LEARNED.md to ensure continuous improvement. </instructions>

FAQ

What does the cowork skill do?

How do I install cowork?

Run npx skills add https://github.com/igorwarzocha/opencode-workflows --skill cowork in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cowork/ (personal) or .claude/skills/cowork/ (project).

Which AI agents can use cowork?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is cowork safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains cowork?

It is published by igorwarzocha in igorwarzocha/opencode-workflows. It has 102 recorded installs.