hyper-cli Skill
Nutze Hyper Marketing Skills und Tools direkt über ein Terminal mit der hyperai Command-Line Interface.
- GitHub Stars
- 112
- Dateien
- 1
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der hyper-cli Skill?
hyper-cli ist ein Agent Skill. Nutze Hyper Marketing Skills und Tools direkt über ein Terminal mit der hyperai Command-Line Interface.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den hyper-cli skill
Die hyper-cli ermöglicht es Entwicklern und Marketern, Marketing-Automatisierungsaufgaben direkt aus einer Terminal-Umgebung heraus auszuführen. Über das hyperai Command-Line Interface können Nutzer spezifische Marketing Skills und Tools außerhalb eines MCP-nativen Agent-Hosts nutzen. Das ist besonders hilfreich, wenn du direkt über eine Shell mit Tools wie gmail_messages_send oder meta_ads_adaccount_list interagieren möchtest.
Die Schnittstelle bietet verschiedene Commands, um deinen Workflow zu verwalten. Du kannst hyperai info verwenden, um deine Authentifizierung und dein Workspace zu prüfen, hyperai search, um gezielt Fähigkeiten zu finden, und hyperai describe, um die Input-Schemas von Tools zu inspizieren. Um eine Aufgabe auszuführen, nutzt du den Befehl hyperai call, gefolgt vom kanonischen Tool-Namen und einem JSON-Objekt, das deine Argumente enthält.
Auch das Management von Verbindungen ist innerhalb der CLI möglich. Du kannst verbundene Accounts für ein spezifisches Toolkit auflisten oder das aktive Konto für deine aktuelle Shell-Session mit den Commands connections_list und connections_use wechseln. So stellst du sicher, dass deine Terminal-Sessions den korrekten Authentifizierungs-Kontext für die Marketing-Tools beibehalten, die du gerade ausführst.
Was ein agent damit machen kann
- 1Spezifische Marketing-Tools findenFinde ein Tool, indem du nach einer Beschreibung der Aufgabe in natürlicher Sprache suchst.
- 2Tool-Anforderungen prüfenLies das Input-Schema eines Tools aus, um sicherzustellen, dass die Argumente korrekt formatiert sind.
- 3Marketing-Aktionen ausführenFühre ein Marketing-Tool über seinen kanonischen Namen unter Verwendung eines JSON-Objekts für die Argumente aus.
- 4Account-Authentifizierung verwaltenWechsle das aktive Konto für ein spezifisches Toolkit innerhalb deiner aktuellen Shell-Session.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den hyper-cli Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den hyper-cli Skill in Plugin installieren
/plugin marketplace add hyperfx-ai/marketing-skills /plugin install hyper-marketing@hyperfx-marketing-skills
Den hyper-cli Skill in Claude Code installieren
~/.claude/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.claude/skills/hyper-cliDen hyper-cli Skill in Claude Code (project) installieren
.claude/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli .claude/skills/hyper-cliDen hyper-cli Skill in Codex installieren
~/.agents/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.agents/skills/hyper-cliDen hyper-cli Skill in Gemini CLI installieren
~/.gemini/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.gemini/skills/hyper-cliDen hyper-cli Skill in Claude.ai installieren
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
Auf GitHub ansehenHyper 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 |
Dateien in diesem Skill
1hyper-cli Skill-Fragen
Wie installiere ich den hyper-cli Skill in Claude Code?
Führe npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.claude/skills/hyper-cli aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den hyper-cli Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Wie finde ich ein bestimmtes Tool in der Hyper CLI?
Du kannst den Befehl hyperai search "<what you want to do>" nutzen, um ein Tool zu finden.
Wie kann ich die erforderlichen Input-Parameter für ein Tool sehen?
Nutze den Befehl hyperai describe <name> --parameters, um das Input-Schema eines Tools einzusehen.
Wie wechsle ich das aktive Konto für ein Toolkit in meiner aktuellen Shell?
Nutze den Befehl hyperai call connections_use --json '{"toolkit_id": "<toolkit_id>", "auth_id": "<auth_id>"}'.
Was soll ich tun, wenn die CLI einen kanonischen Namen ablehnt?
Führe hyperai search "<name>" aus, um den exakten Befehl zu erhalten, oder aktualisiere deine CLI mit hyperai update.