@ear3/claude-plugin
v0.1.2
Published
Ear3 plugin for Claude Code — agent skills plus the bundled Ear3 MCP server to create, deploy, edit, and analyze AI voice interviews.
Readme
@ear3/claude-plugin
Claude Code plugin for
Ear3 — agent skills plus the bundled
@ear3/mcp server. The
skills are the procedures (when to ask, what to report); the MCP server
is the execution layer (typed ear3_* tools, auth kept out of the
conversation). One install wires up both.
Install
/plugin marketplace add https://www.ear3.ai/claude/marketplace.json
/plugin install ear3@ear3Skills are namespaced by the plugin — e.g. /ear3:create-interview
("create an interview about…"). Claude also invokes them on its own
when a task matches a skill's description.
The marketplace catalog (hosted at
https://www.ear3.ai/claude/marketplace.json and mirrored in this repo's
.claude-plugin/marketplace.json) installs the plugin from npm — this
package. Claude Code cannot install plugins via npm install directly;
registering the marketplace is what makes the npm package reachable.
Skills
- create-interview — from a plain-language topic to a deployed, shareable voice interview URL.
- edit-interview — change, translate, reorder, or regenerate an existing interview's questions, persona, and branching.
- integrate-interview — wire an interview into the user's app with
the right SDK layer (
@ear3/voice-interviewerwidget by default, headless for custom UI, hosted URL for non-React sites). - analyze-interview — responses + AI insights turned into a grounded findings report (participation, themes, verbatim quotes).
Skills are procedures, not API references: they prefer the bundled MCP
tools, fall back to the CLI, and defer to the AGENTS.md / llms.txt
of the exact package version in use, so they stay correct across
versions.
Bundled MCP server
.mcp.json starts @ear3/mcp
(stdio, via npx) whenever the plugin is enabled. Authentication is
resolved inside the server — a one-time
npx @ear3/voice-config-cli login, or EAR3_CONFIG_CLI_KEY in the
environment; the secret key never appears in the conversation. Without
auth the tools still connect and return instructions on how to log in.
Versioning
This package is versioned with the rest of the ear3-sdk workspace via
changesets. .claude-plugin/plugin.json mirrors package.json#version
(npm run sync-version before publishing).
