Agent skill

Workspace Authoring

by witnesstodark in witnesstodark/mr-mak-workspace

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

MITAuto-check passed

Install Workspace Authoring

skills CLI
$ npx skills add witnesstodark/mr-mak-workspace --skill workspace-authoring -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install witnesstodark/mr-mak-workspace workspace-authoring --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/witnesstodark/mr-mak-workspace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/workspace-authoring .claude/skills/workspace-authoring && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workspace-authoring
GitHub stars
336
Token cost
~491 tokens
SKILL.md length
247 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

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

  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Workspace Authoring is an agent skill from witnesstodark/mr-mak-workspace. Create or maintain Workspace cards, report tabs and Markdown deliverables with consistent styling, working media previews and clear project organization.

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: A local desktop workspace for Codex and Claude Code, with project reports, creative skills and optional voice. The licence is MIT.

Example prompts

  • “/workspace-authoring”

What it can do on your machine

Read from SKILL.md and the folder at commit 1e0c7c3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workspace Authoring loads about 491 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 247 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~491

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from witnesstodark/mr-mak-workspace at commit 1e0c7c3, republished under its MIT licence (© witnesstodark). 247 words, ~491 tokens.

Download SKILL.mdSave it as .claude/skills/workspace-authoring/SKILL.md (or your agent's skills folder).
name
workspace-authoring
description
Create or maintain Workspace cards, report tabs and Markdown deliverables with consistent styling, working media previews and clear project organization.

Workspace authoring

Read AGENTS.md and the workflow. 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.

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.

Update workspace/workspace.json with a stable ID, category, folder, readable title, creation date, last updated date and steps. sample: true is reserved for starter examples; ordinary work uses normal archiving behavior.

Open every changed tab at wide and narrow sizes. Check media and links, Markdown rendering and image close/download controls. Preserve the selected surface during loading. Report actual verification and any remaining limitations. Prepare desktop changes without restarting active sessions until the user permits it.

© witnesstodark, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/workspace-authoring of witnesstodark/mr-mak-workspace.

Open the folder on GitHubat commit 1e0c7c3

Compare with similar skills

Workspace Authoring next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workspace Authoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workspace Authoring this skillwitnesstodark/mr-mak-workspace336—~491Automated safety check: PassMIT
Authoring Skillsvercel/next.js143k—~1kAutomated safety check: PassMIT
Status Card Querypaperclipai/paperclip99k—~1.6kAutomated safety check: PassMIT
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT
Wiki Maintaineropenclaw/openclaw392k1 repos~462Automated safety check: PassMIT
Routing Card Authoringagentlas-ai/Agentlas-OS1.6k—~2.7kAutomated safety check: PassApache-2.0

Similar skills

  • Authoring Skills

    vercel/next.js

    Official

    How to create and maintain agent skills in .agents/skills/. An agent skill from vercel/next.js.

    143k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Status Card Query

    paperclipai/paperclip

    Create and maintain agent-authored Paperclip status cards, or compile a prose interest prompt into bounded CompanySearchQuery objects and write the first summary from the assigned Summarizer run.

    99k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Wiki Maintainer

    openclaw/openclaw

    Maintain the OpenClaw memory wiki vault with deterministic pages, managed blocks, and source-backed updates.

    392k GitHub starsUsed in 1 repo~462 tokens
    Knowledge ManagementAuto-check passed
  • Routing Card Authoring

    agentlas-ai/Agentlas-OS

    A skill your agent uses whenever a build emits or repairs .agentlas/routing-card.json — the shared card contract for the single-agent builder, the team builder, and the packager.

    1.6k GitHub stars~2.7k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Configuring Oauth2 Authorization Flow

    mukul975/Anthropic-Cybersecurity-Skills

    Configures secure OAuth 2.0 authorization flows, including Authorization Code with PKCE, Client Credentials, and Device Authorization Grant, covering flow selection, PKCE implementation, token…

    34k GitHub stars~1.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed

More from witnesstodark/mr-mak-workspace

All 19 skills in this repo
  • Fal AI Generation

    witnesstodark/mr-mak-workspace

    Generate and edit images, create video, audio, 3D assets or material maps through fal.ai MCP or the Python queue client.

    336 GitHub stars~1k tokensUpdated 3 days ago
    Auto-check: notes
  • Game Vfx Workflow

    witnesstodark/mr-mak-workspace

    Develop game effects from visual references and motion studies through an engine handoff, with event timing, lifecycle, readability and native review.

    336 GitHub stars~896 tokensUpdated 3 days ago
    Auto-check passed
  • Game Audio Workflow

    witnesstodark/mr-mak-workspace

    Build and review game sound banks, map chosen takes to real events, and prepare or verify runtime playback with timing, repetition and mix limits.

    336 GitHub stars~811 tokensUpdated 3 days ago
    Auto-check passed
  • Game Level Design

    witnesstodark/mr-mak-workspace

    Turn a game-level brief or existing scene snapshot into a reviewable spatial plan, then apply approved changes with coordinate, navigation and scene checks.

    336 GitHub stars~735 tokensUpdated 3 days ago
    Auto-check passed
  • Game UI Workflow

    witnesstodark/mr-mak-workspace

    Design and implement game HUDs, menus, icons and portrait systems from visual proposals through reusable engine assets and input checks.

    336 GitHub stars~867 tokensUpdated 3 days ago
    Auto-check passed
  • Gameplay Visual Review

    witnesstodark/mr-mak-workspace

    Verify a visual game change using controlled native captures, targeted behavioral checks and a reviewable evidence record.

    336 GitHub stars~720 tokensUpdated 3 days ago
    Auto-check passed

Questions about Workspace Authoring

What does Workspace Authoring do?

Create or maintain Workspace cards, report tabs and Markdown deliverables with consistent styling, working media previews and clear project organization. Workspace Authoring is an agent skill from witnesstodark/mr-mak-workspace. Create or maintain Workspace cards, report tabs and Markdown deliverables with consistent styling, working media previews and clear project organization.

How do I install Workspace Authoring in Claude Code?

Run `npx skills add witnesstodark/mr-mak-workspace --skill workspace-authoring -a claude-code`. Or copy the skill folder (.agents/skills/workspace-authoring in witnesstodark/mr-mak-workspace) into .claude/skills/workspace-authoring in your project. Claude Code loads it when a task matches its description.

How do I install Workspace Authoring in Codex?

Run `npx skills add witnesstodark/mr-mak-workspace --skill workspace-authoring -a codex`. Or copy the skill folder (.agents/skills/workspace-authoring in witnesstodark/mr-mak-workspace) into .agents/skills/workspace-authoring in your project. Codex loads it when a task matches its description.

Can I use Workspace Authoring in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add witnesstodark/mr-mak-workspace --skill workspace-authoring -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workspace-authoring, .gemini/skills/workspace-authoring, .github/skills/workspace-authoring and .opencode/skills/workspace-authoring in your project.

What does Workspace Authoring need to run?

SKILL.md names no scripts, command-line tools or credentials: Workspace Authoring is instructions for the agent only.

Does Workspace Authoring access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Workspace Authoring safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Workspace Authoring use?

Workspace Authoring is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workspace Authoring use?

About 491 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Workspace Authoring?

Skills that share tags, products or a category with Workspace Authoring: Authoring Skills (vercel/next.js, 143k stars), Status Card Query (paperclipai/paperclip, 99k stars), Hermes Agent Skill Authoring (NousResearch/hermes-agent, 252k stars) and Wiki Maintainer (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workspace Authoring?

witnesstodark (a GitHub user) maintains it in witnesstodark/mr-mak-workspace, which has 336 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 5, 2026.

Source: witnesstodark/mr-mak-workspace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.