debugging-broken-jobs

Triage failed Friday workspace jobs and route them to specialized debug skills.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users frequently waste time misdiagnosing failed Friday workspace jobs, incorrectly claiming platform bugs or FSM wiring issues when the root cause is almost always an agent contract violation or configuration error.

Core Features & Use Cases

  • Structured Triage Table: Maps job failure signatures to the correct specialized debug skill, eliminating guesswork.
  • Mandatory Diagnostic Steps: Enforces pre-escalation checks to prevent false platform bug claims.
  • Use Case: If a job runs but returns empty output, this skill immediately routes you to the dedicated empty-output debug workflow instead of wasting time on unnecessary FSM rewrites.

Quick Start

Use the debugging-broken-jobs skill to diagnose your failed Friday workspace job by first calling describe_session on the failing session and reviewing the agent's tool calls to identify the root cause.

Frequently Asked Questions about debugging-broken-jobs

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

FAQPage Schema
How do I triage broken Friday workspace jobs that return empty output?

To triage broken Friday workspace jobs with empty output, call describe_session on the failing session to review the agent's tool calls. This structured triage process routes you to the dedicated empty-output debug workflow instead of unnecessary FSM rewrites.

Why does my Friday workspace job fail with runtime errors or infinite tool loops?

Friday workspace job failures like runtime errors or infinite tool loops are almost always caused by agent contract violations or configuration errors. Reviewing the agent's tool calls through structured triage identifies the root cause before attributing it to platform bugs.

What is the best way to debug Friday workflow failures without misdiagnosing FSM errors?

The best way to debug Friday workflow failures is to follow mandatory diagnostic steps that validate agent contract compliance. This structured triage approach eliminates misdiagnosis of FSM wiring issues by confirming configuration errors before escalating platform bug claims.

Can I use structured triage to fix incorrect job invocations in Friday workspaces?

Yes, structured triage applies to all Friday workspace job failure scenarios including incorrect job invocations. By mapping job failure signatures to specialized debug skills, it enforces pre-escalation checks to validate agent contracts and route you to the correct resolution workflow.

Do I need to check agent contracts before reporting a Friday workspace job failure as a platform bug?

Yes, you must validate agent contract compliance before reporting a Friday workspace job failure as a platform bug. Mandatory diagnostic steps enforce pre-escalation checks to prevent false platform bug claims caused by configuration errors or contract violations.

What should I do if my Friday workspace job is not working despite correct FSM wiring?

If your Friday workspace job is not working despite correct FSM wiring, use structured triage to map the job failure signature to a specialized debug skill. This enforces checking agent contracts and configuration errors before attributing the failure to the platform.