Skip to content
AI & Agents
Skill

/desk-open

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.

From plugin
awesome-copilot
39k200 skills200 agents
Install
$ npx -y skills add github/awesome-copilot --skill desk-open --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/desk-open

Context preview

The summary Claude sees to decide when to auto-load this skill.

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.

SKILL.md

desk-open.SKILL.md
name: desk-open
description: '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.'

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

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`

2. **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.

3. **Create the structure.** Make the directory, initial journal, and signals folder:

   desks/<desk-name>/journal.md
   desks/<desk-name>/.signals/

4. **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

5. **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:

1. The operator (or TA) starts a session and says "sit at the `<desk-name>` desk" 2. The session reads `desks/<desk-name>/journal.md` to load priors 3. Work happens — the session uses `signal-write` to emit signals and `desk-journal` to persist state at the end 4. 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.

Read more
Ships withawesome-copilot

A community-created collection of custom agents, instructions, skills, hooks, workflows, and plugins to supercharge your GitHub Copilot experience.

Get the whole plugin

Other skills on awesome-copilot.