
Open a Desk
OfficialFreeEfficiently set up new workspaces for focused projects.
Free · Opens the source repo
What Open a Desk does
Open a Desk is a skill designed for developers and designers who need to establish a structured workspace for new projects or workstreams. This skill creates a dedicated directory for each desk, ensuring that all relevant information and context are organized and easily accessible. By setting up a new desk, users can maintain a clear focus on specific topics, allowing for better management of tasks and collaboration with other desks.
When using Open a Desk, the user begins by selecting a descriptive name for their desk, which will serve as the reference point for future sessions. The skill checks if a desk with the same name already exists, preventing accidental overwrites of important data. If the desk is new, it creates a folder structure that includes a journal file for persistent memory and a signals directory for structured output. This organization helps users keep track of their progress and decisions over time.
The journal file is a crucial component of the desk, as it provides a record of the desk's purpose, scope, and next steps. This memory allows users to pick up where they left off in future sessions, ensuring continuity in their work. The skill emphasizes that each desk should have a specific focus to maximize its effectiveness, encouraging users to create multiple desks if their projects are broad in scope. Overall, Open a Desk streamlines the process of starting new workstreams, making it easier for teams to collaborate and maintain clarity in their projects.
When to use it
Use this skill when initiating a new workstream or when a specific topic requires its own dedicated workspace.
When not to use it
This skill is not suitable for ongoing projects that do not require a new desk or for tasks that can be managed within existing structures.
What you can build with it
Starting a New Project
When beginning a new project, use Open a Desk to create a dedicated workspace that organizes all relevant information.
Managing Multiple Workstreams
For teams handling various projects, this skill allows the creation of separate desks for each workstream, ensuring focused attention.
Documenting Progress
Use the journal feature to document decisions and progress, making it easier to track the evolution of each project over time.
How to install Open a Desk
View source1. Install with the skills CLI
npx skills add github/awesome-copilot/desk-open --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by githubOpen a Desk
Create a new desk in the workshop with the standard structure.
When to use
- The operator wants to start a new workstream
- Work arrives that doesn't belong to any existing desk
- A topic needs its own frame (its own history, its own priors)
What it creates
Given a workshop directory and a desk name, create:
desks/<desk-name>/
journal.md # persistent memory — read at start, written at end
.signals/ # structured signal output (JSON) — dashboard reads this
How to use
-
Choose a name. Short, descriptive, kebab-case. The name is how the operator and other desks refer to this desk. Examples:
security-scan,api-review,ops,cloud-workshop -
Check if it already exists. If
desks/<desk-name>/already has ajournal.md, the desk is live — do not overwrite it. Instead, resume it: read the journal and continue from where it left off. If the operator explicitly wants a fresh start, they must rename or archive the existing desk first. -
Create the structure. Make the directory, initial journal, and signals folder:
desks/<desk-name>/journal.md desks/<desk-name>/.signals/ -
Write the first journal entry. The journal starts with:
- What this desk is for (its focus/purpose)
- What repos or work it covers (if applicable)
- Any initial context the first session needs
-
Announce it. Tell the operator what was created and what the desk's focus is.
Session orientation
This skill initializes storage — it does not launch a session. A desk becomes active when a Copilot session references its directory. The session workflow:
- The operator (or TA) starts a session and says "sit at the
<desk-name>desk" - The session reads
desks/<desk-name>/journal.mdto load priors - Work happens — the session uses
signal-writeto emit signals anddesk-journalto persist state at the end - The next session repeats from step 2
The desk identity comes from which journal is read, not from a persistent process. Desks are long-running in state (the journal carries forward), not in runtime (each session is independent).
Journal format
# <Desk Name> — Journal
## <date> — Desk opened
- **Purpose:** <what this desk focuses on>
- **Scope:** <repos, areas, or work this desk covers>
- **Next step:** <what the first session should do>
Principles
- A desk is a peer, not a sub-agent. It has equal standing to disagree with other desks.
- The journal is the memory. Without it, the next session starts blind. Write enough that someone starting from zero finds the way.
- One desk, one focus. If the scope is too broad, open two desks. Each desk's value comes from its specific frame — dilute the frame and you lose the value.
Frequently asked questions about Open a Desk
Similar skills
Canva Creator
Streamline your content campaign from brief to HubSpot.
Cowork Plugin Customization
Tailor your Claude Code plugin to fit your organization.
Impediment Prioritization
Rank and prioritize impediments effectively.
Chronicle
Streamline your Copilot session analysis and reporting.
Idea Refine
Transform vague ideas into actionable concepts.
App Store Optimization
Optimize your mobile app's visibility and performance.
