writing-workspace-jobs

Validate Friday FSM workspace job schemas, signal triggers, and MCP tool references.

97|5|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/friday-platform/friday-studio --skill writing-workspace-jobs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-workspace-jobs
Source: https://github.com/friday-platform/friday-studio/tree/main/packages/system/skills/writing-workspace-jobs
Command: npx skills add https://github.com/friday-platform/friday-studio --skill writing-workspace-jobs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill eliminates the common, silent runtime failures that occur when authoring, editing, or debugging FSM workspace jobs and signals for Friday, saving developers hours of troubleshooting misconfigured workflows that fail without clear error messages.

Core Features & Use Cases

  • Pre-publish validation checklists: Catch structural errors like mismatched signal names, missing final states, and incorrect MCP tool prefixes before deploying workflows.
  • End-to-end workflow guidance: Covers FSM structure, trigger contracts, multi-step agent pipelines, signal payload threading, sub-agent delegation, and output contracts for returning data to callers.
  • Use case: A developer building an automated inbox triage workflow can use this Skill to correctly wire the trigger signal, chain a triage agent to a Linear ticket-creation agent, and ensure the processed output is properly returned to the calling chat or webhook.

Quick Start

Use the writing-workspace-jobs skill to build a new FSM job that triages incoming support emails and routes them to the correct Linear team based on content.

Frequently Asked Questions about writing-workspace-jobs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug silent runtime failures in Friday FSM workspace jobs?

Silent runtime failures in Friday FSM workspace jobs stem from misconfigured finite state machines, incorrect signal trigger bindings, or malformed MCP tool references. Applying pre-publish validation checklists catches structural errors like missing final states and incorrect MCP prefixes before workflows deploy.

How do I wire signal triggers and chain agent pipelines in a Friday workflow?

Wiring signal triggers and chaining agent pipelines in a Friday workflow requires correct signal payload threading between states and proper sub-agent delegation. You must bind the initial trigger signal, chain agents through defined FSM transitions, and ensure the final output contract properly returns data to the calling chat or webhook.

What is signal payload threading and when do I need it for multi-step agent pipelines?

Signal payload threading is the process of passing data correctly between states in a multi-step agent pipeline within an FSM workflow. You need it when chaining agents, such as routing triaged content from an inbox triage agent to a downstream ticket-creation agent, to maintain data integrity across transitions.

How do I validate MCP tool references and naming conventions before publishing a workspace job?

Validating MCP tool references involves checking that tool naming conventions and prefixes match the expected MCP server integration schemas before publishing. Pre-publish validation checklists verify correct MCP prefixes, proper output contracts for returning data to callers, and overall FSM job schema correctness to prevent silent failures.

Can I use Friday workspace jobs to build an automated inbox triage workflow with Linear integration?

Yes, Friday workspace jobs support automated inbox triage workflows by wiring a trigger signal to a triage agent, chaining it to a Linear ticket-creation agent via FSM transitions, and using output contracts to return processed results. Proper signal payload threading ensures data flows correctly between the triage and ticket-creation stages.

Why does my Friday workflow fail without a clear error message when chaining sub-agents?

Friday workflows fail silently when sub-agent delegation includes mismatched signal names, missing final states, or incorrect MCP tool prefixes. Without validated job schemas and proper output contracts for returning data to callers, the finite state machine cannot complete transitions, causing runtime failures without explicit errors.