troubleshoot-earl

Name: troubleshoot-earl
Availability: InStock
Author: Mathematic

Diagnose and resolve Earl CLI installation, template, secret, and MCP issues.

112|7|Updated Feb 22, 2026

Search Tags:#debugging #troubleshooting #cli #mcp #hcl #earl

Ready to run

npx skills add https://github.com/mathematic-inc/earl --skill troubleshoot-earl-mathematic-inc

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: troubleshoot-earl
Source: https://github.com/mathematic-inc/earl/tree/main/skills/development/troubleshoot-earl
Command: npx skills add https://github.com/mathematic-inc/earl --skill troubleshoot-earl-mathematic-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve common problems encountered when using the Earl command-line interface, ensuring smooth integration with AI agents and external services.

Core Features & Use Cases

Installation Failures: Guides through installing Earl if it's not detected.
Template Errors: Identifies and suggests fixes for HCL and Jinja template syntax and logic issues.
Authentication Problems: Assists in setting up and verifying necessary secrets for API access.
MCP Connectivity: Helps configure and troubleshoot the Earl integration with AI agent communication protocols.
SSRF Blocks: Provides guidance on handling Server-Side Request Forgery prevention measures.
Use Case: When earl call returns an error or MCP tools are not appearing in your agent, use this Skill to systematically identify and fix the underlying configuration or installation issue.

Quick Start

Run earl doctor to start diagnosing Earl problems.

Frequently Asked Questions about troubleshoot-earl

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

FAQPage Schema

How do I troubleshoot Earl CLI installation failures and missing dependencies?▼

To troubleshoot Earl CLI installation failures, run `earl doctor` to detect whether Earl is installed and identify missing dependencies. This diagnostic command checks your environment and guides you through completing the installation and resolving setup errors.

Why does my HCL template fail to parse with undefined variable errors in Earl?▼

HCL template parse failures and undefined variable errors in Earl occur when syntax or variable references are invalid. Run `earl doctor` to validate your configuration files, identify the specific HCL or Jinja template syntax issues, and apply the suggested fixes.

How do I fix MCP connectivity issues when Earl tools are not appearing in my AI agent?▼

MCP connectivity issues where Earl tools are not appearing in your AI agent stem from misconfigured integration settings. Run `earl doctor` to diagnose the MCP communication protocol connection, verify your configuration, and re-establish tool visibility.

How do I resolve authentication problems and set up API secrets for Earl CLI?▼

Authentication problems in the Earl CLI are resolved by verifying and setting up the necessary API access secrets. Run `earl doctor` to identify missing credentials, then configure your secret management variables to restore authenticated API access.

What should I do when Earl blocks requests due to SSRF prevention measures?▼

When Earl blocks requests due to Server-Side Request Forgery (SSRF) prevention measures, use this Skill to get guidance on handling the blocks. Run `earl doctor` to diagnose the SSRF restrictions and adjust your configuration to comply with security policies.