MR
Mayur Rathi
@github
⭐ 34.1k GitHub stars

Desk-Open

Desk-Open is an code AI skill with a core value of Create and open a new desk in the workshop. It helps developers solve real-world problems in the code domain, boosting efficiency, automating repetitive tasks, and optimizing workflows.

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.

Last verified on: 2026-08-02

Quick Facts

Category code
Works With Claude, GitHub Copilot
Source github/awesome-copilot
Stars ⭐ 34.1k
Last Verified 2026-08-02
Risk Level Low
mkdir -p ./skills/desk-open && curl -sfL https://raw.githubusercontent.com/github/awesome-copilot/main/skills/desk-open/SKILL.md -o ./skills/desk-open/SKILL.md

Run in terminal / PowerShell. Requires curl (Unix) or PowerShell 5+ (Windows).

Skill Content

# 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:


text
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


markdown
# <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.

🎯 Best For

  • Claude users
  • GitHub Copilot users
  • Software engineers
  • Development teams
  • Tech leads

💡 Use Cases

  • Code quality improvement
  • Best practice enforcement

📖 How to Use This Skill

  1. 1

    Install the Skill

    Copy the install command from the Terminal tab and run it. The SKILL.md file downloads to your local skills directory.

  2. 2

    Load into Your AI Assistant

    Open Claude or GitHub Copilot and reference the skill. Paste the SKILL.md content or use the system prompt tab.

  3. 3

    Apply Desk-Open to Your Work

    Open your project in the AI assistant and ask it to apply the skill. Start with a small module to verify the output quality.

  4. 4

    Review and Refine

    Review AI suggestions before committing. Run tests, check for regressions, and iterate on the skill output.

❓ Frequently Asked Questions

Is Desk-Open compatible with Cursor and VS Code?

Yes — this skill works with any AI coding assistant including Cursor, VS Code with Copilot, and JetBrains IDEs.

Do I need specific dependencies for Desk-Open?

Check the install command and Works With section. Most code skills only require the AI assistant and your codebase.

How do I install Desk-Open?

Copy the install command from the Terminal tab and run it. The skill downloads to ./skills/desk-open/SKILL.md, ready to use.

Can I customize this skill for my team?

Absolutely. Edit the SKILL.md file to add team-specific instructions, examples, or workflows.

⚠️ Common Mistakes to Avoid

Skipping validation

Always test AI-generated code changes, even for simple refactors.

Missing dependency updates

Check if the skill requires updated dependencies or new packages.

🔗 Related Skills