debugging-job-invocation

Diagnose workspace job tool output-errors caused by missing prompt arguments.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves the common issue where workspace job tools called from chat return an output-error with no meaningful error text, typically caused by invoking the tool with a bare empty object instead of a required prompt argument, and prevents users from making incorrect assumptions like the tool being unbound from the chat session.

Core Features & Use Cases

  • Correct invocation guidance: Enforces the required prompt argument for job tool calls, with fallback to job-specific schema parameters when applicable, eliminating bare empty object call errors.
  • Job pattern clarification: Distinguishes between Pattern A sequential jobs and Pattern B FSM jobs to prevent incorrect migration fixes for empty output issues.
  • Unbound tool workaround: Provides the trigger_signal method for running newly created jobs that are not yet bound to the active chat session, avoiding unnecessary prompts for users to send new messages.
  • Use Case: If a chat user calls a workspace reporting job and receives an output-error with no details, this Skill guides them to add the correct prompt parameter instead of assuming the tool is misconfigured or unbound.

Quick Start

Use this Skill to troubleshoot a workspace job tool that returned an output-error when called from chat, starting by verifying the invocation included a required prompt argument.

Frequently Asked Questions about debugging-job-invocation

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

FAQPage Schema
Why does my workspace job tool return an output-error with no details when called from chat?

Workspace job output-errors with no details typically occur when the tool is invoked with a bare empty object instead of the required prompt argument. Passing the correct prompt parameter resolves this issue.

How do I fix chat invocation errors for workspace jobs returning empty output?

To fix empty output from workspace jobs, verify the invocation includes the required prompt argument rather than a bare empty object. Check job-specific schema parameters and ensure you are not misdiagnosing the tool as unbound.

What is the difference between Pattern A sequential jobs and Pattern B FSM jobs for chat invocation?

Pattern A sequential jobs and Pattern B FSM jobs represent different execution models. Migrating from Pattern A to Pattern B does not resolve empty output errors caused by missing prompt arguments in chat invocations.

How do I trigger a newly created workspace job that is not yet bound to the active chat session?

Use the trigger_signal method to run newly created workspace jobs not yet bound to the active chat session. This workaround avoids unnecessary prompts for users to send new messages.

Do I need to pass a prompt argument every time I call a workspace job tool from chat?

Yes, workspace job tools require a prompt argument for correct invocation from chat. Falling back to job-specific schema parameters may apply, but bare empty object calls will consistently fail.

What should I check when workspace job debugging shows an unbound tool error?

When debugging an unbound tool error, first verify the invocation included the required prompt argument. The tool may not actually be unbound; empty output-errors are frequently caused by incorrect argument passing.