script-kit-logging

Implement structured JSONL logging and correlation IDs for Script Kit GPUI applications.

28|6|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/johnlindquist/script-kit-next --skill script-kit-logging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: script-kit-logging
Source: https://github.com/johnlindquist/script-kit-next/tree/main/.claude/skills/script-kit-logging
Command: npx skills add https://github.com/johnlindquist/script-kit-next --skill script-kit-logging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides clear patterns and best practices for logging within the Script Kit GPUI environment, enabling effective debugging, observability, and error tracking.

Core Features & Use Cases

  • Structured Logging: Understand and implement JSONL logging for detailed event tracking.
  • AI Log Mode: Learn to use the compact stderr format for efficient AI agent communication.
  • Error Handling: Implement robust error management using anyhow and thiserror.
  • Use Case: When a script fails unexpectedly, use the logging patterns to trace the execution flow, identify the root cause using correlation IDs, and quickly resolve the issue.

Quick Start

Enable compact AI logs by running your script with the SCRIPT_KIT_AI_LOG=1 environment variable.

Frequently Asked Questions about script-kit-logging

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

FAQPage Schema
How do I implement structured logging in Script Kit GPUI applications?

Enable compact AI logs in Script Kit by setting the SCRIPT_KIT_AI_LOG=1 environment variable, which outputs a compact stderr format designed for efficient AI agent communication.

How do I trace execution flow and identify root causes when a Script Kit script fails?

Trace execution flow and identify root causes in failed scripts by implementing correlation IDs within your structured logs, allowing you to track specific events and quickly resolve issues.

What is the best way to handle errors in Script Kit scripts?

Handle errors in Script Kit scripts robustly by utilizing the anyhow and thiserror patterns, providing clear error management strategies alongside structured logging for better observability.

When do I need JSONL format for debugging application behavior?

You need JSONL format for debugging application behavior when you require structured logging that captures detailed, machine-readable event tracking data to monitor and trace complex execution flows.