skills.rest
mathematic-inc
mathematic-incOFFICIAL
Explore all skills by this author →
GitHub

troubleshoot-earl

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
One-click install
npx skills add https://github.com/mathematic-inc/earl --skill troubleshoot-earl-mathematic-inc
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
brwsebrwse
112

create-template

Create Earl HCL templates for external services and commands.

Official
Advanced
mathematic-incmathematic-inc
112

migrate-to-earl

Scan codebases and replace raw API/CLI calls with Earl templates.

Official
Advanced
brwsebrwse
112

troubleshoot-earl

Diagnose and fix Earl CLI, HCL template, Jinja render, authentication, MCP, and SSRF issues.

Official
Intermediate
humansyshumansys
71

rai-doctor

Diagnose RaiSE setup issues by parsing rai doctor --json output.

Official
Intermediate