insites-debugging

Diagnose Insites defects by validating source files and reading runtime logs.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/insites-io/insites-logic-engine --skill insites-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: insites-debugging
Source: https://github.com/insites-io/insites-logic-engine/tree/main/skills_examples/insites-debugging
Command: npx skills add https://github.com/insites-io/insites-logic-engine --skill insites-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly identify, validate, and resolve problems in Insites applications by combining static audit checks with runtime log analysis.

Core Features & Use Cases

  • Code Validation: Run audit checks to catch Liquid syntax errors, missing tags, invalid filters, and missing frontmatter before they reach production.
  • Log Analysis: Inspect live logs to trace errors, warnings, authorization failures, GraphQL issues, and missing partials back to their source.
  • Use Case: When a staging deploy starts failing, use this Skill to validate the codebase, stream logs, isolate the failing file or query, and confirm the fix before redeploying.

Quick Start

Ask the AI to validate the relevant Insites files and analyze the latest staging logs for any errors or warnings.

Frequently Asked Questions about insites-debugging

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

FAQPage Schema
How do I debug Liquid template errors and missing partials in Insites applications?

Debug Liquid template errors and missing partials by validating source files against audit rules to catch syntax issues, invalid filters, and missing frontmatter. Runtime log analysis then traces execution failures back to their originating source files.

What is the best way to trace GraphQL query failures and authorization errors during an Insites staging deploy?

Trace GraphQL query failures and authorization errors by streaming runtime logs to inspect live execution data, isolating the failing query or permission block, and validating the fix before redeploying to staging or production environments.

How do I validate Insites source files before deploying to production?

Validate Insites source files by running static audit checks to catch Liquid syntax errors, missing tags, invalid filters, and missing frontmatter. This static validation prevents deployment regressions before code reaches production environments.

Can I use insites-cli to monitor live logs for deployment regressions in production?

Yes, you can use insites-cli logsv2 to stream live runtime logs for production environments, inspecting errors, warnings, and authorization failures to identify and confirm fixes for deployment regressions.

Does Insites debugging support handling exclusion patterns for audit warnings?

Yes, Insites debugging supports clean handling of critical errors, warnings, and exclusion patterns during static validation to help you filter noise and focus on actual application defects.