Skill hyper-cli
Ejecuta las Agent Skills y herramientas de Hyper marketing directamente desde una terminal usando la interfaz de línea de comandos hyperai.
- Estrellas en GitHub
- 112
- Archivos
- 1
- Último commit
- 11 nov 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill hyper-cli?
hyper-cli es una agent skill. Ejecuta las Agent Skills y herramientas de Hyper marketing directamente desde una terminal usando la interfaz de línea de comandos hyperai.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill hyper-cli
Ejecutar tareas de automatización de marketing desde un entorno de terminal es lo que hyper-cli permite a desarrolladores y especialistas en marketing. Al usar la interfaz de línea de comandos hyperai, los usuarios pueden ejecutar herramientas y Agent Skills de marketing específicas fuera de un host de agente nativo de MCP. Esto es útil cuando necesitas interactuar con herramientas como gmail_messages_send o meta_ads_adaccount_list directamente a través de una shell.
La interfaz proporciona varios comandos para gestionar tu flujo de trabajo. Puedes usar hyperai info para verificar tu autenticación y espacio de trabajo, hyperai search para localizar capacidades específicas e hyperai describe para inspeccionar los esquemas de entrada de las herramientas. Para ejecutar una tarea, utilizas el comando hyperai call seguido del nombre canónico de la herramienta y un objeto JSON que contiene tus argumentos.
También es posible gestionar las conexiones dentro de la CLI. Puedes listar las cuentas conectadas para un toolkit específico o cambiar la cuenta activa para tu sesión de shell actual usando los comandos connections_list y connections_use. Esto asegura que tus sesiones de terminal mantengan el contexto de autenticación correcto para las herramientas de marketing que estés ejecutando.
Lo que un agente puede hacer con ella
- 1Localizar herramientas de marketing específicasEncuentra una herramienta buscando una descripción en lenguaje natural de la tarea.
- 2Inspeccionar los requisitos de una herramientaLee el esquema de entrada de una herramienta para asegurar que los argumentos tengan el formato correcto.
- 3Ejecutar acciones de marketingEjecuta una herramienta de marketing por su nombre canónico usando un objeto JSON para los argumentos.
- 4Gestionar la autenticación de cuentasCambia la cuenta activa para un toolkit específico dentro de tu sesión de shell actual.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill hyper-cli
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill hyper-cli en Plugin
/plugin marketplace add hyperfx-ai/marketing-skills /plugin install hyper-marketing@hyperfx-marketing-skills
Instalar la skill hyper-cli en Claude Code
~/.claude/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.claude/skills/hyper-cliInstalar la skill hyper-cli en Claude Code (project)
.claude/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli .claude/skills/hyper-cliInstalar la skill hyper-cli en Codex
~/.agents/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.agents/skills/hyper-cliInstalar la skill hyper-cli en Gemini CLI
~/.gemini/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.gemini/skills/hyper-cliInstalar la skill hyper-cli en Claude.ai
npx degit hyperfx-ai/marketing-skills/skills/hyper-cli hyper-cli && zip -r hyper-cli.zip hyper-cli # claude.ai → Customize → Skills → + → Create skill → Upload a skill → hyper-cli.zip
SKILL.md
Ver en GitHubHyper CLI
Use hyperai to run any marketing skill from a terminal. A skill names each tool once, by its canonical name, for example gmail_messages_send. The CLI runs that name directly.
Requirements
- Hyper MCP configured for the workspace. https://app.hyperfx.ai/mcp
- Required integrations connected at https://app.hyperfx.ai/apps. The sibling marketing skill lists which integrations it needs.
- Hyper CLI installed and authenticated. Verify with
hyperai info.
If hyperai info fails, stop and tell the user to authenticate the CLI before calling tools.
The four commands
| Need | Command |
|---|---|
| Confirm auth and workspace | hyperai info |
| Find a tool | hyperai search "<what you want to do>" |
| Read a tool's input schema | hyperai describe <name> --parameters |
| Run a tool | hyperai call <name> --json '{...}' |
<name> is the canonical tool name from the skill, such as meta_ads_adaccount_list. The CLI also accepts the same name as separate words (meta-ads adaccount list); a skill never uses that form.
If your CLI version rejects the canonical name, run hyperai search "<name>": the result prints the exact hyperai call ... line to use. Update the CLI with hyperai update.
Connected accounts
| Need | Command |
|---|---|
| List the connected accounts for a toolkit | hyperai call connections_list --json '{"toolkit_id": "gmail"}' |
| Switch the active account for this shell | hyperai call connections_use --json '{"toolkit_id": "gmail", "auth_id": "<auth_id>"}' |
The active account is kept per shell session, the same way the MCP keeps it per session.
Arguments
- Pass arguments as one JSON object with
--json. The CLI validates them against the tool's schema before calling. - When a call fails with an argument error, run
hyperai describe <name> --parametersand read the schema. Do not retry the same arguments. - Large results: add
--rawto get the unformatted JSON.
Example
hyperai info
hyperai search "send an email"
hyperai describe gmail_messages_send --parameters
hyperai call gmail_messages_send --json '{"to": "jane@example.com", "subject": "Hello", "body": "Hi Jane"}'
Out of scope
| Need | Skill |
|---|---|
| What to send, to whom, in which sequence | the marketing skill that owns the job, for example cold-email-outreach |
| MCP client setup | the Hyper MCP page at https://app.hyperfx.ai/mcp |
Archivos de esta skill
1Preguntas sobre la skill hyper-cli
¿Cómo instalo la skill hyper-cli en Claude Code?
Ejecuta npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.claude/skills/hyper-cli. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill hyper-cli?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Cómo encuentro una herramienta específica en la Hyper CLI?
Puedes usar el comando hyperai search "<what you want to do>" para encontrar una herramienta.
¿Cómo puedo ver los parámetros de entrada requeridos para una herramienta?
Usa el comando hyperai describe <name> --parameters para leer el esquema de entrada de una herramienta.
¿Cómo cambio la cuenta activa para un toolkit en mi shell actual?
Usa el comando hyperai call connections_use --json '{"toolkit_id": "<toolkit_id>", "auth_id": "<auth_id>"}'.
¿Qué debo hacer si la CLI rechaza un nombre canónico?
Ejecuta hyperai search "<name>" para obtener el comando exacto que debes usar, o actualiza tu CLI con hyperai update.