Desk Open
GitHubOfficialFirst committed by jennyf19Distributed by GitHub
- Skill
- Workflow
- Agent tooling
- MIT
- No issues found
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
Download the skill as a ZIP:
https://autogineer.com/agent-skills/github/desk-open/downloadUnzip 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 thisHow 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 priorsWork happens — the session uses
signal-writeto emit signals anddesk-journalto persist state at the endThe 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
- ATTRIBUTION.mdAdded by AutoGineer851 B
- LICENSELicence file added by AutoGineer1.0 KiB
- SKILL.md3.0 KiB
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
jennyf19
- 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