Best for
- 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)
github/awesome-copilot/skills/desk-open/SKILL.md
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.
Decision brief
Create a new desk in the workshop with the standard structure.
Compatibility matrix
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/github/awesome-copilot --skill "skills/desk-open"Inspect the Agent Skill "desk-open" from https://github.com/github/awesome-copilot/blob/9933dcad5be5caeb288cebcd370eeeb2fc2f1685/skills/desk-open/SKILL.md at commit 9933dcad5be5caeb288cebcd370eeeb2fc2f1685. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
1. 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
The operator wants to start a new workstream
Given a workshop directory and a desk name, create:
This skill initializes storage — it does not launch a session. A desk becomes active when a Copilot session references its directory. The session workflow:
Permission review
The documentation asks the agent to create, modify, or delete local files.
**Create the structure.** Make the directory, initial journal,Evidence record
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 81/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 37,126 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Create a new desk in the workshop with the standard structure.
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
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 a journal.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:
Announce it. Tell the operator what was created and what the desk's focus is.
This skill initializes storage — it does not launch a session. A desk becomes active when a Copilot session references its directory. The session workflow:
<desk-name> desk"desks/<desk-name>/journal.md to load priorssignal-write to emit signals
and desk-journal to persist state at the endThe 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).
# <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>