convez.ai
SkillProdutividadeIntermediário
andreboekhorst

Claude Workspace Designer

andreboekhorst/claude-workspace-designer

Crie workflows de IA com skills customizadas para seus projetos Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta para criar e gerenciar projetos Claude Cowork com skills personalizadas específicas de cada projeto. Permite definir comportamentos, manter memória persistente e exportar configurações reutilizáveis sem necessidade de codificação manual.

Instalação

$npx convez-ai andreboekhorst/claude-workspace-designer

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Preparação para entrevistas de emprego
  • Pipelines de conteúdo e publicação
  • Redação de teses e documentos acadêmicos
  • Gerenciamento de finanças pessoais
  • Planejamento de viagens e campanhas criativas

Veredito

Skill robusto que transforma Claude Cowork em plataforma versátil de workflows, com assistentes que se auto-configuram. Excelente para projetos estruturados que precisam de comportamentos ajustáveis sem tocar código.

README

A tradução para o português deste README ainda está na fila.

Header



Add skills to your projects

Workspace designer adds skills to your Claude Cowork projects, and only to that project. This allows you to create workflows adjusted to your project needs. Since these skills write themselves you don't need to touch any code. You can continuously adjust and finetune its behaviour, and when you are happy, you can even export a clean project configuration for you to share and reuse.

  • 🐙 Skills for Cowork
  • 🦈 Persistent Memory
  • 🦦 Flexible behaviours
  • 🧙🏻 Shape Personalities
  • ⛵️ Export, Share, Re-use

Getting Started

Getting started is easy, all you need to do is download this workspace, and open up the folder and say hi! We will guide you through the rest.

  1. Download this workspace
  2. Unzip the file
  3. Open Claude Desktop, go to Claude Code
  4. Under the "Projects" section, click the + button to create a new Project
  5. Select "Use an existing folder", and select the folder you just unzipped
  6. Say hi! A setup wizard will walk you through configuration.

Wizard

Exporting and Reusing

When you are happy with your workspace, you can export and reuse it for others. Just ask to export the project. It will strip any personal files from the project and create a zip file.

🐙 Examples

These are just some of the workspaces you can build — pick a blueprint and make it yours.

WorkspaceDescription
Job Interview PrepNail your next interview by researching the company and practicing structured answers.
Content PipelineStay on top of your publishing schedule by planning, drafting, and editing in one place.
Dungeon MasterRun a great campaign by generating NPCs, prepping sessions, and tracking lore.
Fiction WritingWrite better stories by building worlds, drafting scenes, and self-critiquing your plot.
Recipe CollectionOrganize your kitchen by photographing recipes, planning meals, and generating grocery lists.
Thesis WritingFinish your thesis by organizing sources, structuring chapters, and drafting with citations.
Travel PlanningPlan the perfect trip by researching destinations, building itineraries, and packing smart.
Personal FinanceTake control of your money by importing bank data, tracking spending, and setting goals.

🐙 Core Workflows

Every workspace comes with these built-in workflows:

  • Setup — First-time configuration wizard that creates your folder structure and initial skills
  • Add Skill — Create new skills by describing what you need; Claude writes the instructions
  • Add Reference — Register files, URLs, or background knowledge that skills can draw on
  • Resume — Pick up where you left off with a summary of recent activity and next steps
  • Reflect — Review your session and suggest workspace improvements
  • Set Personality — Define the workspace's voice, tone, and character
  • Export — Package your workspace into a clean, shareable template
  • Help — List all available skills and what they do

🏖️ F.A.Q.

How Does It Work?

Claude Cowork is basically Claude Code under the hood. That means it can write its own prompts! With this in mind we created a specification for a workspace that contains a defined structure, and a set of configurations, skills, logs, and references. When you run an empty project for the first time, it will use these predefined configurations to help you set up a workspace and create skills. Read more of this specification below.

When we first start a conversation with a workspace, it triggers a setup-flow that helps you define your needs for a workspace. When that's done - it will start writing all of the skills themselves.

What are workspace specifications?

In the Workspace specifications we propose a structure to which we can enable container-based Claude projects. It contains a set of built-in skills, logs and user generated skills. All of these skills are being triggered through progressive disclosure.

What is Progressive Disclosure?

Whenever you add new skills to your workflow, they are not added directly to the prompt. In the main entry file (CLAUDE.md) we list all available skills with a reference to the full instructions. The detailed instructions are only loaded on-demand when a skill is activated.

Can I reuse the skills?

Claude Cowork doesn't really support project-based skills yet. So the skills within this project are not the same as the skills for claude code. But if you want to, you could take the individual skills file from the _workspace/skills and turn it into a Claude Code command.

Is it safe?

When you run someone else's prompts on your computer, and you give it access to your files, there are inherent risks involved. So please always check the playbooks for any weird prompts (Claude cowork could actually help with that).

Whats next?

Currently, Claude Cowork is in it's infancy and it does not have the nice features that claude chat has to display and interact with people. But eventually this will grow. Also, I think having containerised llm packages are the way forward and we will probably be able to create software fully written and shaped by its user in a similar unboarding steps.


Meme

🐠 The Workspace specification

The Workspace specification defines how a folder must be structured so Claude can discover skills, load instructions on demand, and operate as a domain-specific assistant. Any workspace — whether built by hand or generated — should follow this spec.

Core Concepts

  • CLAUDE.md as entry point — Claude reads this file upfront. It contains just enough to identify user intent and route to the right skill file.
  • Progressive disclosure — Full skill instructions live in separate files and are loaded on-demand. This keeps the initial context small and focused.
  • Skills — Standalone markdown files that tell Claude exactly what to do. Split into system skills (setup, logging, etc.) and user skills (what makes your workspace unique).
  • References — Background knowledge, user settings, and context that help skills perform better.

Folder Structure

Every workspace that follows the specification looks like this:

my-workspace/
  CLAUDE.md                            # Entry point. The only file Claude reads upfront.
  _workspace/
    config/                            # System skills (not user-facing).
      _setup.md                        # Onboarding and configuration.
      _log.md                          # Session logging.
      _add-reference.md                # Reference management.
      _add-skill.md                    # Skill builder.
      _export-workspace.md             # Export and packaging.
    skills/                            # User-facing skills. One file per skill.
      [skill-name].md
    references/                        # References and user settings (filled during setup).
      user-settings.md
    logs/                              # Session logs. Gitignored.

Rules:

  • _workspace/ is reserved: don't use it for user content
  • Files prefixed with _ are system files
  • All user data folders must be gitignored

CLAUDE.md Spec

The entry point. Claude reads this upfront and uses it to route user intent to skill files. It must contain these sections, in order:

Header

# [Workspace Title]
- Name: [short name]
- Description: [what this workspace does]
- Version: [version number]
- Author: [who made it]

Requirements

What the workspace needs. Two levels:

  • Hard: Won't work without these. Setup should block or warn prominently.
  • Recommended: Works without these, but some skills will be limited.

If there are no hard requirements, say so explicitly.

## Requirements

### Hard
None — this Workspace works out of the box.

### Recommended
- Google Calendar MCP: Enables calendar-based skills. Without it, skills relying on calendar data require manual input.

Folder Structure

Lists all folders, split into system folders (versioned, part of the template) and user data folders (gitignored, created during setup).

## Folder Structure

### System folders (versioned, part of the template)
- `_workspace/config/`: Internal system skills
- `_workspace/skills/`: User-facing skill instructions

### User data folders (gitignored, personal to each user)
- `_workspace/references/`: Reference material, background knowledge, and user settings
- `_workspace/logs/`: Session logs

Skills

Maps user intent to skill files. Every entry needs a name, a file path, and trigger examples. Split into:

  • Default Skills: Setup, Logging, Add Context, Add Skill, Export. System skills present in every workspace.
  • User Skills: What makes this workspace unique.

Must end with: Before executing any skill, you MUST read its instruction file in full.

## Skills
Claude activates the matching skill based on user intent. Read the user's intent and activate automatically — do not wait for a command.

### Default Skills
These are default skills that come with any workspace:
- Setup (`_workspace/config/_setup.md`): Says "set up my space", "configure", or opens the project for the first time.
- Logging (`_workspace/config/_log.md`): Session logging, runs after every skill.
- Add Reference (`_workspace/config/_add-reference.md`): Wants to add background knowledge or reference material.
- Add Skill (`_workspace/config/_add-skill.md`): Wants to add a new skill.
- Export Workspace (`_workspace/config/_export-workspace.md`): Wants to export, share, or package the workspace.

### User Skills
- [Skill Name] (`_workspace/skills/[filename].md`): [Trigger description with 2-3 example phrases]

Before executing any skill, you MUST read its instruction file in full. This is progressive disclosure — the detailed instructions are loaded on-demand, not upfront.

Ground Rules

Must include at least these four:

  • User data is sacred: never overwrite or delete without permission
  • Never invent: only use what the user actually provided
  • Always log sessions: run the logging skill after every skill
  • Read files first: never edit a file you haven't read in this session

Authors can add more.

Tone

How Claude should communicate. Without it, Claude defaults to generic behavior.

Do Not

Explicit anti-patterns for this workspace.

Setup Trigger

Last line. Triggers the setup skill on first run, then gets commented out:

ACTIVATE: Setup skill — read `_workspace/config/_setup.md` and execute.

Skill Files

Each skill is a standalone markdown file. It should contain everything Claude needs — don't assume context from other files.

Guidelines:

  • Be specific: tell Claude what to do, what to ask, what to output, where to save
  • Include examples: show expected output format, file naming, templates
  • State constraints: if the skill has rules, state them explicitly

Default Skills

Every workspace includes these system skills in _workspace/config/:

SkillFilePurpose
Setup_setup.mdFirst-run onboarding: verify folders, check requirements, personalize settings, show available skills
Logging_log.mdRuns after every skill: appends to daily log, records what happened and what changed
Add Reference_add-reference.mdRegister documents, URLs, or background knowledge as reference material
Add Skill_add-skill.mdInteractively create new skills and register them in CLAUDE.md
Export_export-workspace.mdPackage the workspace for sharing (clean template or full export)

🐡 Building Your Own

  1. Copy this repo or create the structure from scratch
  2. Write your CLAUDE.md following the specification spec above
  3. Create your setup skill in _workspace/config/_setup.md
  4. Add skill files to _workspace/skills/
  5. Zip and share

⚠️ Security Notice

Workspaces are essentially prompt files that instruct Claude how to behave. Before using any workspace you didn't author yourself, read every markdown file in the project — especially CLAUDE.md and the skill files in _workspace/. Treat them like code: a malicious or poorly written prompt could instruct Claude to overwrite files, exfiltrate content, or behave in unexpected ways. Only run workspaces from sources you trust, and review any changes before applying them to your own setup.

Ver o original no GitHub

Bom para

Relacionados