henry

Henry - Skills & Plugin

Henry's agent plugin: gives AI coding agents live commerce tools (product search, carts, hosted checkout) plus skills that teach them how to integrate Henry into the apps they build.

What's inside

• .mcp.json — auto-starts the Henry MCP server (npx -y @henrylabs/mcp@latest) so installed agents get live commerce tools.
• skills/integrate — model-invoked skill: triggers when a user asks to add commerce/checkout/product search to their app; teaches @henrylabs/sdk setup, async-job polling, hosted vs headless checkout, webhooks, and go-live.
• skills/shop — user-invoked demo: /henry:shop white sneakers under $100 → real product search → cart → hosted checkout link.

Three ways to consume this directory

1. Claude Code plugin (full bundle: MCP wiring + namespaced skills). From the public mirror repo:

   /plugin marketplace add Henry-Social/skills
   /plugin install henry@henrylabs
   

   This directory is also its own marketplace (.claude-plugin/marketplace.json beside plugin.json). For local development in the monorepo: claude --plugin-dir ./apps/skills. Then /henry:shop <query> or just ask Claude to integrate Henry.

2. Cross-agent skills via the Agent Skills standard — the same skills/*/SKILL.md files work in Codex CLI, Cursor, ChatGPT's skills beta, and 30+ other agents:

   npx skills add Henry-Social/skills
   

   Skills installed this way don't include the MCP wiring — the shop skill walks users through adding the Henry MCP server manually.

3. ChatGPT App — a hosted in-chat app is a different artifact (remote MCP server + widgets). Henry's remote OAuth MCP server is the substrate it would build on; see https://docs.henrylabs.ai.

This directory is developed in the (private) henry monorepo and mirrored to the public Henry-Social/skills repo by CI on every change to dev. Don't edit the mirror directly — changes there are overwritten by the next sync. Found a problem? Open an issue on Henry-Social/skills or email [email protected]; pull requests against the mirror are clobbered by the next sync.

Requirements

• Node.js 18+ with npx on the PATH (the MCP server runs via npx).
• A Henry API key: create an app at https://app.henrylabs.ai → Developer settings. Start with a sandbox key.
• export HENRY_SDK_API_KEY="<key>" in the shell that launches the agent. Without it the MCP server still starts; tool calls fail with 401 and the shop skill walks the user through onboarding.

Privacy note: the published MCP server is a Stainless "Code Mode" build whose code-execution tool runs on Stainless-hosted sandboxes by default. Pass --code-execution-mode=local in .mcp.json args to keep execution on-machine.

Development

From this directory (or the mirror repo root):

# Structural validation (manifests, MCP config, skill frontmatter)
bun run lint

# Full plugin + marketplace validation via the Claude Code CLI
claude plugin validate .

# Live-test in a session; /reload-plugins picks up edits without restarting
claude --plugin-dir .

From the henry monorepo root the same commands are bun run --filter @henry/skills lint, claude plugin validate ./apps/skills, and claude --plugin-dir ./apps/skills.

Skill content is distilled from https://docs.henrylabs.ai and Henry's v1 OpenAPI spec (which lives in the private henry monorepo, not in this repo — the live API reference at https://docs.henrylabs.ai covers the same surface). When endpoints change, update skills/integrate/references/ to match.