earl

Execute external service, database, and shell commands via HCL templates.

112|7|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/mathematic-inc/earl --skill earl-mathematic-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: earl
Source: https://github.com/mathematic-inc/earl/tree/main/skills/runtime/earl
Command: npx skills add https://github.com/mathematic-inc/earl --skill earl-mathematic-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a secure and standardized way to interact with external services, databases, and the command line, abstracting away the complexities of direct tool usage.

Core Features & Use Cases

  • API Interaction: Seamlessly call external APIs using pre-defined HCL templates.
  • Database Queries: Execute SQL queries against databases.
  • Shell Command Execution: Run system commands securely.
  • Use Case: You need to search for GitHub repositories matching specific criteria. Instead of using gh or curl directly, you use Earl to find and execute the appropriate github.search_repos command.

Quick Start

Use the earl skill to search for github repositories with more than 100 stars that are written in rust.

Frequently Asked Questions about earl

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

FAQPage Schema
How do I securely execute shell commands and database queries from an AI agent?

You can securely execute shell commands and database queries from an AI agent by using HCL-templated interfaces that abstract direct tool usage, managing secrets and validating operations to ensure AI safety.

What is the best way to call external APIs without exposing secrets to an LLM?

The best way to call external APIs without exposing secrets to an LLM is to use an HCL-templated interface that abstracts tools like curl, managing secrets and validating operations securely.

Can I run SQL database queries through an MCP discovery mode?

Yes, you can run SQL database queries through an MCP discovery mode, as the interface supports both MCP discovery and CLI modes for command execution and parameter handling.

Does this approach work with direct command line tools like gh and psql?

Yes, this approach works with command line tools like gh and psql by abstracting their direct usage, allowing you to find and execute commands such as searching GitHub repositories through a secure interface.

Why use HCL templates for API interaction and command execution?

HCL templates provide a secure and standardized way to interact with external services, databases, and the command line, abstracting away the complexities and security risks of direct tool usage.

When should I not use direct curl or shell commands with my AI workflow?

You should not use direct curl or shell commands when your AI workflow requires secure secrets management and operation validation, as an HCL-templated interface provides necessary abstraction for AI safety.