One-click install
npx skills add https://github.com/friday-platform/friday-studio --skill debugging-runtime-errors-friday-platform
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-runtime-errors
Source: https://github.com/friday-platform/friday-studio/tree/main/packages/system/skills/debugging-runtime-errors
Command: npx skills add https://github.com/friday-platform/friday-studio --skill debugging-runtime-errors-friday-platform

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a Friday agent session fails with a runtime error, manually parsing error messages and tracing configuration contracts to find a fix is time-consuming and error-prone. This skill eliminates that friction by mapping every common runtime error pattern directly to its precise one-line fix.

Core Features & Use Cases

  • Comprehensive error coverage: Handles all standard Friday runtime failure patterns including missing complete tool calls, empty agent outputs, schema validation failures, invalid job/signal config rejections, and signal payload mismatches.
  • Actionable fixes: Each error entry includes a clear, specific fix aligned with Friday's official configuration and agent handshake contracts, plus cross-references to deeper documentation for context.
  • Guardrails: Explicitly calls out common missteps to avoid, such as retrying contract violations without fixing the root cause or incorrectly migrating workspace patterns to work around prompt errors.
  • Use case: For example, if your agent session fails with the error "LLM action with outputTo '<doc>' did not call complete", this skill immediately tells you to update the agent's prompt to explicitly invoke the complete tool with the required response argument.

Quick Start

Use the debugging-runtime-errors skill to fix the runtime error from your most recent failed Friday agent session.

Frequently Asked Questions about debugging-runtime-errors

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

FAQPage Schema
How do I fix the Friday agent error "did not call complete" during a runtime session?

To fix the Friday runtime error where the LLM action did not call complete, update the agent's prompt to explicitly invoke the complete tool with the required response argument.

What causes empty agent outputs and output schema validation failures in Friday?

Empty agent outputs and schema validation failures in Friday are common runtime errors caused by mismatched workspace configurations and agent handshake contracts that require precise one-line configuration fixes.

How do I resolve Zod-rejected job and signal configuration errors in Friday?

Resolve Zod-rejected job and signal configuration errors in Friday by mapping the specific runtime failure pattern to its corresponding workspace configuration fix aligned with official agent contracts.

What should I avoid doing when troubleshooting Friday agent runtime errors?

When troubleshooting Friday agent runtime errors, avoid retrying contract violations without fixing the root cause and do not incorrectly migrate workspace patterns to work around prompt errors.

Can I use this skill to debug signal payload validation errors for any Friday agent?

Yes, you can debug signal payload validation errors for standard Friday agents by matching the exact error pattern to predefined fixes aligned with Friday's workspace configuration and handshake contracts.