Agent skill

Workspace API

by friday-platform in friday-platform/friday-studio

Create, list, update, delete, and clean up workspaces via the daemon HTTP API at $FRIDAYDURL.

Custom licenceAuto-check: notesBackend & APIs

Install Workspace API

skills CLI
$ npx skills add friday-platform/friday-studio --skill workspace-api -a claude-code

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

GitHub CLI
$ gh skill install friday-platform/friday-studio workspace-api --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/friday-platform/friday-studio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/system/skills/workspace-api .claude/skills/workspace-api && 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-api
GitHub stars
104
Token cost
~9.3k tokens
SKILL.md length
4,358 words
Files
8 (incl. references, assets)
Skills in repo
20
Repo updated
First seen
Licence
Custom licence

At a glance

Create, list, update, delete, and clean up workspaces via the daemon HTTP API at $FRIDAYDURL.

  • Works in 7 steps: List available capabilities → Wire capabilities → Connect credentials → …
  • The user asks to create
  • SKILL.md covers Cheat sheet, Reachability model — the…, Recipe: build or modify a… and Direct mode vs draft mode —…, plus 7 more sections
  • Runs TypeScript scripts from its folder; calls curl and jq

What it does

Workspace API is an agent skill from friday-platform/friday-studio. Create, list, update, delete, and clean up workspaces via the daemon HTTP API at $FRIDAYDURL. Use when the user asks to create, edit, delete, or list workspaces, spaces, projects, or environments; add or patch signals / agents / jobs / memory / skills; convert a workspace.yml into a live workspace; wire up triggers (HTTP webhooks, cron, fs-watch, Slack / Telegram / WhatsApp); or clean up test/scratch workspaces.

Its SKILL.md is about 9.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files and assets (for example `assets/example-jobs-pipeline.yml`, `assets/example-kb-workspace.yml` and `references/agent-types.md`).

It sits in Backend & APIs, covering Webhooks, Scheduled and recurring tasks and REST APIs. It works with Slack, Telegram and WhatsApp. The repository describes itself as: Agent Harness Platform — shareable workspaces, MCP tools, skills, memory, and cron/webhook automations. Self-hosted and transparent.

When your agent uses it

  • The user asks to create
  • List workspaces
  • Patch signals / agents / jobs / memory / skills
  • Convert a workspace.yml into a live workspace

Example prompts

  • “/workspace-api”

Requirements

  • Python 3
  • Node.js

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. List available capabilities
  2. Wire capabilities
  3. Connect credentials
  4. Decide direct vs draft mode
  5. Upsert in dependency order
  6. Validate
  7. Publish (draft only)

What it can do on your machine

Read from SKILL.md and the folder at commit fb3069a. 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

    Ships script files (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • jq

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

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    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 API loads about 9.3k tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 108 tokens; SKILL.md has 4,358 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~108
When it runs · the whole SKILL.md, loaded when a task matches
~9.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~16k

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

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:243
    w use `$FRIDAYD_URL`. Source the daemon `.env` once
  • NoteMentions a .env fileSKILL.md:249
    . "${FRIDAY_HOME:-$HOME/.friday/local}/.env" 2>/dev/null \
  • NoteMentions a .env fileSKILL.md:250
    || . "$HOME/.atlas/.env" 2>/dev/null || true

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 4,358 words (~9,286 tokens).

“Create and manage Friday workspaces. This skill is where LLM judgment lives: when to use each tool, in what order, and how to recover when stuck. Companion skills: friday-cli (daemon lifecycle, signals, sessions) and using-mcp-servers (MCP catalog, install/enable, credentials).”

— opening of SKILL.md by friday-platform, Custom licence
name
workspace-api

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (references, assets) in packages/system/skills/workspace-api of friday-platform/friday-studio.

  • SKILL.md
  • assets/example-jobs-pipeline.yml
  • assets/example-kb-workspace.yml
  • references/agent-types.md
  • references/messaging-signals.md
  • references/platform-friday-yml.md
  • references/updating-workspaces.md
  • skill-content.test.ts

Open the folder on GitHubat commit fb3069a

Compare with similar skills

Workspace API 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 API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workspace API this skillfriday-platform/friday-studio104—~9.3kAutomated safety check: NotesCustom licence
Channel Debug Corevercel-labs/vercel-openclaw-archived117—~2kAutomated safety check: NotesMIT
Frontmcp Channelsagentfront/frontmcp146—~3.7kAutomated safety check: PassApache-2.0
Ak Dev New Messaging Integrationyaalalabs/agent-kernel191—~4.2kAutomated safety check: PassApache-2.0
Hitl ProtocolLeoYeAI/openclaw-master-skills2.2k—~5.3kAutomated safety check: PassApache-2.0
Ak Add Integrationyaalalabs/agent-kernel191—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Channel Debug Core

    vercel-labs/vercel-openclaw-archived

    Official

    Channel webhook triage for vercel-openclaw Slack/Telegram/Discord/WhatsApp issues: prove deployment state, collect admin readiness endpoints, build evidence-first handoff before fixes.

    117 GitHub stars~2k tokensUpdated 4 mo ago
    Backend & APIsAuto-check: notes
  • Frontmcp Channels

    agentfront/frontmcp

    A skill your agent uses when pushing real-time notifications or events into Claude Code (or another MCP client) sessions, or building two-way chat bridges.

    146 GitHub stars~3.7k tokensUpdated today
    Backend & APIsAuto-check passed
  • Ak Dev New Messaging Integration

    yaalalabs/agent-kernel

    Step-by-step guide for adding a new messaging platform integration to Agent Kernel.

    191 GitHub stars~4.2k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Hitl Protocol

    LeoYeAI/openclaw-master-skills

    HITL Protocol — the open standard for human decisions in autonomous agent workflows.

    2.2k GitHub stars~5.3k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Ak Add Integration

    yaalalabs/agent-kernel

    Add a messaging platform integration to an existing Agent Kernel project.

    191 GitHub stars~2.6k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Whatsapp Telegram

    ericrisco/rsc-harness

    A skill your agent uses when wiring an app or agent to message customers over the WhatsApp Cloud API or a Telegram bot — order updates, OTP codes, reminders, alerts and broadcasts — or when…

    156 GitHub stars~2.9k tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from friday-platform/friday-studio

All 20 skills in this repo
  • Authoring Skills

    friday-platform/friday-studio

    Authors new agent skills that follow the Anthropic + agentskills.io specification.

    104 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Friday CLI

    friday-platform/friday-studio

    Interacts with a running Friday daemon via CLI and HTTP — lists/creates/modifies workspaces, triggers signals, watches sessions, publishes skills and agents.

    104 GitHub stars~4.3k tokensUpdated 1 mo ago
    Auto-check: notes
  • Writing Workspace Signals

    friday-platform/friday-studio

    Authors Friday workspace signals with correct provider configs, payload schemas, and runtime wiring.

    104 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Composing Emails

    friday-platform/friday-studio

    General styling and tone guidelines for composing HTML emails.

    104 GitHub stars~648 tokensUpdated 1 mo ago
    Auto-check passed
  • Repairing Workspaces Agents

    friday-platform/friday-studio

    Repairs and upgrades existing Friday workspaces, jobs, user agents, and generated agents to current runtime contracts.

    104 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check passed
  • Using Elicitations

    friday-platform/friday-studio

    Asks the user mid-run from inside an FSM action or Python type: user agent via the elicitation tools — requesttoolaccess for allowlist approvals and requesthumaninput for HITL (human-in-the-loop)…

    104 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Workspace API

What does Workspace API do?

Create, list, update, delete, and clean up workspaces via the daemon HTTP API at $FRIDAYDURL. Workspace API is an agent skill from friday-platform/friday-studio. Create, list, update, delete, and clean up workspaces via the daemon HTTP API at $FRIDAYDURL.

When should I use Workspace API?

Workspace API fits situations like: the user asks to create; list workspaces; patch signals / agents / jobs / memory / skills; convert a workspace.yml into a live workspace.

How do I install Workspace API in Claude Code?

Run `npx skills add friday-platform/friday-studio --skill workspace-api -a claude-code`. Or copy the skill folder (packages/system/skills/workspace-api in friday-platform/friday-studio) into .claude/skills/workspace-api in your project. Claude Code loads it when a task matches its description.

How do I install Workspace API in Codex?

Run `npx skills add friday-platform/friday-studio --skill workspace-api -a codex`. Or copy the skill folder (packages/system/skills/workspace-api in friday-platform/friday-studio) into .agents/skills/workspace-api in your project. Codex loads it when a task matches its description.

Can I use Workspace API 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 friday-platform/friday-studio --skill workspace-api -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-api, .gemini/skills/workspace-api, .github/skills/workspace-api and .opencode/skills/workspace-api in your project.

What does Workspace API need to run?

Going by SKILL.md and its folder, Workspace API needs TypeScript for the scripts in its folder and the command-line tools its instructions call (curl and jq). Our summary lists: Python 3; Node.js.

Does Workspace API access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Workspace API safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Workspace API use?

Workspace API has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Workspace API use?

About 9.3k tokens (SKILL.md is roughly 37k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.1k tokens, read only when the agent opens those files.

What are the alternatives to Workspace API?

Skills that share tags, products or a category with Workspace API: Channel Debug Core (vercel-labs/vercel-openclaw-archived, 117 stars), Frontmcp Channels (agentfront/frontmcp, 146 stars), Ak Dev New Messaging Integration (yaalalabs/agent-kernel, 191 stars) and Hitl Protocol (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workspace API?

friday-platform (a GitHub organization) maintains it in friday-platform/friday-studio, which has 104 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on September 5, 2026.

Source: friday-platform/friday-studio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.