# Workspace Authoring

Create or maintain Workspace cards, report tabs and Markdown deliverables with...

- Repository: https://github.com/witnesstodark/mr-mak-workspace (642 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add witnesstodark/mr-mak-workspace --skill workspace-authoring -g -a claude-code -y`
Codex: `npx skills add witnesstodark/mr-mak-workspace --skill workspace-authoring -g -a codex -y`
Cursor: `npx skills add witnesstodark/mr-mak-workspace --skill workspace-authoring -g -a cursor -y`
Gemini CLI: `npx skills add witnesstodark/mr-mak-workspace --skill workspace-authoring -g -a gemini-cli -y`

## Description

Create or maintain Workspace cards, report tabs and Markdown deliverables with consistent styling, working media previews and clear project organization.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Workspace authoring

Read `AGENTS.md` and [the workflow](../../../processes/workspace-authoring.md).
Keep authored content in English unless the user explicitly requests another
language. Put related iterations in an existing card rather than creating
several cards for one task. Do not reorganize unrelated projects.

For a gallery or research page that the owner wants to edit directly, use the
versioned `.card.json` format in [editable cards](../../../docs/editable-cards.md).
Register its step with `viewer: "card"`. Keep stable entry IDs, relative local
images and Markdown notes; validate with `desktop/service/card-schema.mjs` before
saving. Reread the source before each edit and update the registry date. The app
provides the view, so do not create a second editable HTML copy of the same data.
Preserve existing custom HTML unless conversion was requested. Browser and phone
previews can read these cards; the desktop Workspace provides editing controls.

Use `workspace/_shared/report.css` and `report.js` in every HTML report, with
`data-mak-report="document"` on the root element. Use the shared tokens and
layout instead of inventing another visual theme. Basic cards and media grids
can use the sample CSS in `workspace/_shared/examples.css`.
Standard reports follow the reader's Dark, Light or System preference. Check
both dark and light when adding custom styles. An intentionally independent
design, such as a game demo, can keep its palette with `data-mak-theme="custom"`
on the root element. Do not invert or recolor media to implement a theme.

Every image must be clickable, preview at full size and offer a download.
Use local output paths, meaningful alt text and lazy loading. Keep motion
studies playable with native video controls. Wide tables must scroll within
the report. Never cover the document close button with the Files rail.

The rest: https://github.com/witnesstodark/mr-mak-workspace/blob/HEAD/.agents/skills/workspace-authoring/SKILL.md