playbooks

home / skills / different-ai / agent-bank / workspace-guide

workspace-guide skill

/.opencode/skill/workspace-guide

This skill guides new OpenWork users through setup, usage, and onboarding workflows, highlighting practical steps and benefits.

npx playbooks add skill different-ai/agent-bank --skill workspace-guide

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
1.6 KB
---
name: workspace-guide
description: Workspace guide to introduce OpenWork and onboard new users.
---

# Welcome to OpenWork

Hi, I\'m Ben and this is OpenWork. It\'s an open-source alternative to Claude\'s cowork. It helps you work on your files with AI and automate the mundane tasks so you don\'t have to.

Before we start, use the question tool to ask:
"Are you more technical or non-technical? I\'ll tailor the explanation."

## If the person is non-technical
OpenWork feels like a chat app, but it can safely work with the files you allow. Put files in this workspace and I can summarize them, create new ones, or help organize them.

Try:
- "Summarize the files in this workspace."
- "Create a checklist for my week."
- "Draft a short summary from this document."

## Skills and plugins (simple)
Skills add new capabilities. Plugins add advanced features like scheduling or browser automation. We can add them later when you\'re ready.

## If the person is technical
OpenWork is a GUI for OpenCode. Everything that works in OpenCode works here.

Most reliable setup today:
1) Install OpenCode from opencode.ai
2) Configure providers there (models and API keys)
3) Come back to OpenWork and start a session

Skills:
- Install from the Skills tab, or add them to this workspace.
- Docs: https://opencode.ai/docs/skills

Plugins:
- Configure in opencode.json or use the Plugins tab.
- Docs: https://opencode.ai/docs/plugins/

MCP servers:
- Add external tools via opencode.json.
- Docs: https://opencode.ai/docs/mcp-servers/

Config reference:
- Docs: https://opencode.ai/docs/config/

End with two friendly next actions to try in OpenWork.

Overview

This skill is a workspace guide that introduces OpenWork and helps onboard new users to a CLI-first banking-for-agents environment. It explains differences for technical and non-technical users, outlines how to enable skills and plugins, and points to where configuration and integrations live. The goal is quick orientation so users can start working with files and AI-assisted automation confidently.

How this skill works

The guide asks an initial preference question to tailor the explanation to technical or non-technical users. For non-technical users it explains how to add files, request summaries, or generate checklists. For technical users it shows how OpenWork maps to OpenCode, where to install and configure providers, and how to add skills, plugins, and external tool servers via configuration files.

When to use it

  • Onboard a new teammate to OpenWork and explain core workflows.
  • Show non-technical users how to safely work with files and get AI summaries.
  • Help developers connect OpenWork to OpenCode and external providers.
  • Decide whether to add skills, plugins, or MCP servers for extra capabilities.
  • Reference when configuring models, API keys, or opencode.json integrations.

Best practices

  • Start by asking whether the user is technical or non-technical to tailor guidance.
  • Keep sensitive files restricted to only the workspace areas you trust.
  • Install and configure providers in OpenCode before starting complex sessions.
  • Install skills from the Skills tab and add plugins via opencode.json for reproducibility.
  • Document any MCP servers or external tools you add to opencode.json for team visibility.

Example use cases

  • A new hire who needs a simple walkthrough: show how to drop files and ask for summaries.
  • A project manager who wants weekly checklists and document drafts generated from workspace files.
  • A developer integrating model providers and API keys via OpenCode, then running sessions in OpenWork.
  • An automation lead adding a scheduling plugin to trigger routines from workspace prompts.
  • Next actions to try: Ask 'Are you more technical or non-technical?' and then 'Summarize the files in this workspace.'

FAQ

Do I need to be technical to use OpenWork?

No. Non-technical users can upload files and ask the AI to summarize, organize, or draft content. Technical users get extra options for provider and plugin configuration.

Where do I configure model providers and plugins?

Install and configure providers in OpenCode, then use the Skills tab or opencode.json and the Plugins tab to add skills and plugins. Keep opencode.json under version control for reproducible setups.