desk-open
Lets your agent create and open a new workspace. It organizes the folder structure and journal to make work easier.
What it does
This tool creates a new 'workspace' (called a 'desk') to organize your tasks. It sets up a folder with a 'memory' file (journal) and a place for important notes.
When to use it
- ✓When you want to start a new project or workstream.
- ✓When work arrives that doesn't fit into anything you already have.
- ✓When a topic needs its own separate history and context.
Example of what to ask your AI
“Create a new workspace called 'code-review'.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You give a name for the new workspace. The tool creates a folder with that name, a file to store history and notes, and a place for important information.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add github/awesome-copilot --skill desk-openOr download just the file:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/desk-open/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Open 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-workshopCheck 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.
FAQ
What is a 'desk'?
Think of a 'desk' as an organized folder for a specific project, with its own memory and context.
What happens if the 'desk' already exists?
If the 'desk' already exists, the tool won't overwrite it. Instead, it suggests you continue from where you left off by reading the existing history.
How does the 'desk' remember things?
It uses a file called 'journal.md' which stores the history and notes. Each time you use the 'desk', it reads this file to know what happened before.
Details
Original description by the author
Create and open a new desk in the workshop. Sets up the folder structure, initial journal, and desk identity so the next session that sits down finds the trail.
repo: github/awesome-copilot
Popularity
- GitHub stars
- 40k
- Ranking position
- #5115
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
acquire-codebase-knowledge
Helps your agent understand and document an existing code project. It's useful for onboarding new people or getting an overview of the architecture.
github/awesome-copilot
acreadiness-assess
Enables your agent to assess a project's readiness for AI and generate a report. It's useful for understanding how well a project is prepared to use AI tools.
github/awesome-copilot
acreadiness-generate-instructions
Helps your agent create instructions for AI tools based on an assessment. It's useful for improving how AI interacts with code and closing identified gaps.
github/awesome-copilot
acreadiness-policy
Enables your agent to help define or apply policies for AI project assessment. It's useful for standardizing how projects are evaluated and ensuring compliance.
github/awesome-copilot
Similar skills
benchmark
Helps your agent measure code speed and performance. It's useful for ensuring things are fast and finding slowness issues.
affaan-m/ECC
content-hash-cache-pattern
Lets your agent use content hashes to cache file processing results. This avoids repeated processing and auto-invalidates the cache when content changes. Useful for speeding up slow tasks.
affaan-m/ECC
parallel-execution-optimizer
Makes your agent speed up complex tasks by breaking them into smaller parts and running them in parallel. It ensures everything is verified at the end.
affaan-m/ECC