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.