Skip to main content
EQ
Foundry
Back to Guides
adoption · Everyone

Contributing a Tool to EQ Foundry

How to add your own skill, hook, or script to the EQ Foundry catalog

Overview

EQ Foundry catalogs all agentic tools at EverQuote. Adding your skill, hook, or script to the catalog makes it discoverable and installable by every team.

What Can You Contribute?

TypeDescriptionExample
SkillA Claude Code skill with a SKILL.mdeq-execute, eq-review
HookA shell script triggered by Claude eventssession-context, branch-guard
AgentA specialized review or analysis agenteq-review-security
ScriptA standalone utility scriptconvention-scan

Step 1: Create the Skill

Create a SKILL.md file in .claude/skills/your-tool-name/:

---
name: your-tool-name
description: What your tool does in one sentence
---

# Your Tool Name

## Overview
What it does and why someone would use it.

## When to Use
The triggers that should make someone reach for this tool.

## How It Works
Step-by-step usage instructions.

Step 2: Add a Catalog Entry

Create apps/web/src/content/tools/your-tool-name.md with the required frontmatter:

---
name: your-tool-name
description: "One-line description"
type: skill
category: workflow
status: experimental
source: internal
roles: [engineering]
repo: your-repo-name
maintainer: "@your-github-handle"
installCommand: "npx skills add mclaude95/eq-foundry -s your-tool-name"
tags: [relevant, tags]
---

Required Fields

  • type: skill, hook, agent, script, command, plugin, mcp-server, or workflow
  • category: workflow, review, implementation, reference, design, integration, or guardrail
  • status: experimental (new), beta (tested), or verified (production-ready)
  • source: internal (EQ-built), vetted (reviewed external), or community
  • roles: who should use this: engineering, design, security, devops, product, content, or analytics

Step 3: Add Body Content

Below the frontmatter, add these sections:

  • Overview: what it does
  • When to Use: when to reach for it
  • Usage Examples: concrete invocations
  • Configuration: any setup needed
  • Installation: the install command

Step 4: Open a PR

Open a PR against mclaude95/eq-foundry with both the skill implementation and the catalog entry. Your entry appears on the next deploy.

Guidelines

  • List only installable tools: if npx skills add cannot find it, omit the catalog entry
  • Start with status: experimental and upgrade as the tool proves itself
  • Include roles so your tool appears on the correct role pages
  • Write the description for someone encountering your tool for the first time