Generated banner for Desk Open
Generated logo for Desk Open

Desk Open

GitHubOfficialFirst committed by jennyf19Distributed by GitHub

  • Skill
  • Workflow
  • Agent tooling
  • MIT
  • No issues found

From 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.
— the description by jennyf19

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The desk-open skill establishes a standardized environment for organizing workstreams. By creating a dedicated directory, a persistent journal file, and a signals folder, it allows AI sessions to maintain continuity. It treats desks as independent, stateful entities where the journal serves as the primary memory, ensuring that subsequent sessions can pick up exactly where previous work left off without requiring a persistent runtime process.

What it does

  • Creates a dedicated directory for a specific workstream.
  • Initializes a journal.md file for tracking history and context.
  • Sets up a .signals directory for structured output.
  • Provides a template for recording the desk's purpose, scope, and initial tasks.
  • Enables state persistence across independent AI sessions.

When to use it

  • When starting a new, distinct workstream.
  • When incoming work does not fit into existing desk structures.
  • When a specific topic requires its own history and set of priors.
  • When you need to ensure future sessions have access to past context.

Advantages

  • Maintains clear separation of concerns by isolating work into specific desks.
  • Ensures continuity by providing a persistent memory via the journal.
  • Prevents context loss between independent AI sessions.
  • Standardizes the workspace structure for better organization.

Usage examples

“Create a new desk named security-scan.”
The agent creates the directory desks/security-scan/, initializes the journal.md with the standard template, and sets up the .signals/ folder.
“I need to start working on the API documentation, open a desk for it.”
The agent checks if desks/api-documentation/ exists; if not, it creates the structure and prompts the user to define the desk's purpose and scope.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/github/desk-open/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip desk-open.zip -d .agents/skills

Documentation by jennyf19

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.

Files

Requirements and compatibility

Written for: GitHub Copilot

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

First committed by
GitHub avatar of jennyf19jennyf19
Publisher
GitHub (Official)
Distributed by
GitHub
Source
github/awesome-copilot · skills/desk-open · commit 797337f
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced
Contributors
jennyf19

AutoGineer is not affiliated with or endorsed by jennyf19 or GitHub.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download desk-open.zip