GroqCloud Automation
Scannednpx machina-cli add skill ComposioHQ/awesome-claude-skills/groqcloud-automation --openclawGroqCloud Automation
Automate AI inference workflows using GroqCloud's ultra-fast API -- chat completions, model discovery, audio translation, and TTS voice selection -- all orchestrated through the Composio MCP integration.
Toolkit docs: composio.dev/toolkits/groqcloud
Setup
- Connect your GroqCloud account through the Composio MCP server at
https://rube.app/mcp - The agent will prompt you with an authentication link if no active connection exists
- Once connected, all
GROQCLOUD_*tools become available for execution
Core Workflows
1. Discover Available Models
List all models available on GroqCloud to find valid model IDs before running inference.
Tool: GROQCLOUD_LIST_MODELS
No parameters required -- returns all available models with metadata.
Use this as a prerequisite before any chat completion call to ensure you reference a valid, non-deprecated model ID.
2. Run Chat Completions
Generate AI responses for conversational prompts using a specified GroqCloud model.
Tool: GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model ID from GROQCLOUD_LIST_MODELS |
messages | array | Yes | Ordered list of {role, content} objects (system, user, assistant) |
temperature | number | No | Sampling temperature 0-2 (default: 1) |
max_completion_tokens | integer | No | Max tokens to generate |
top_p | number | No | Nucleus sampling 0-1 (default: 1) |
stop | string/array | No | Up to 4 stop sequences |
stream | boolean | No | Enable SSE streaming (default: false) |
3. Inspect Model Details
Retrieve detailed metadata for a specific model including context window and capabilities.
Tool: GROQCLOUD_GROQ_RETRIEVE_MODEL
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model identifier (e.g., groq-1-large) |
4. Translate Audio to English
Translate non-English audio files into English text using Whisper models.
Tool: GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION
| Parameter | Type | Required | Description |
|---|---|---|---|
file_path | string | Yes | Local path, HTTP(S) URL, or base64 data URL for audio |
model | string | No | Model ID (default: whisper-large-v3). Note: whisper-large-v3-turbo may not support translations |
response_format | string | No | json, verbose_json, or text (default: json) |
temperature | number | No | Sampling temperature 0-1 (default: 0) |
5. List TTS Voices
Enumerate available text-to-speech voices for Groq PlayAI models to drive voice selection UX.
Tool: GROQCLOUD_LIST_VOICES
Returns the set of supported TTS voices. Note: this is a static list maintained manually.
Known Pitfalls
| Pitfall | Details |
|---|---|
| Nested model list | GROQCLOUD_LIST_MODELS response may be nested at response['data']['data'] -- do not assume a flat top-level array |
| Hard-coded model IDs break | Always fetch model IDs dynamically via GROQCLOUD_LIST_MODELS; hard-coded names can break when models are deprecated or renamed |
| Audio format validation | GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION rejects invalid or unsupported audio formats silently -- validate inputs before calling |
| Model metadata drifts | Data from GROQCLOUD_GROQ_RETRIEVE_MODEL (context window, features) can change as models update -- do not treat it as static |
| TTS voice changes | Voice sets from GROQCLOUD_LIST_VOICES may shrink or rename over time -- handle missing voices gracefully |
Quick Reference
| Tool Slug | Purpose |
|---|---|
GROQCLOUD_LIST_MODELS | List all available models and metadata |
GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION | Generate chat-based AI completions |
GROQCLOUD_GROQ_RETRIEVE_MODEL | Get detailed info for a specific model |
GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION | Translate non-English audio to English text |
GROQCLOUD_LIST_VOICES | Retrieve available TTS voices for PlayAI |
Powered by Composio
Source
git clone https://github.com/ComposioHQ/awesome-claude-skills/blob/master/composio-skills/groqcloud-automation/SKILL.mdView on GitHub Overview
GroqCloud Automation orchestrates AI inference workflows through Composio MCP, covering chat completions, model discovery, audio translation, and TTS voice selection. It streamlines end-to-end AI tasks by unifying GroqCloud tools under a single integration.
How This Skill Works
Connect your GroqCloud account to the Composio MCP server, then use GROQCLOUD_* tools to perform discovery, chat, translation, and voice listing. The workflow relies on fetching valid model IDs with GROQCLOUD_LIST_MODELS, composing chats with GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION, translating audio via GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION, and enumerating TTS voices with GROQCLOUD_LIST_VOICES.
When to Use It
- Before running any chat completion, discover available GroqCloud models to ensure a valid, non-deprecated model ID.
- Build interactive chat-driven apps by generating responses with GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION using a selected model.
- Translate non-English audio to English with GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION to prep content for downstream tasks.
- Power voice-enabled experiences by listing or selecting TTS voices with GROQCLOUD_LIST_VOICES.
- Inspect model capabilities and context (e.g., context window) using GROQCLOUD_GROQ_RETRIEVE_MODEL to fine-tune prompts and settings.
Quick Start
- Step 1: Connect your GroqCloud account through the Composio MCP server at https://rube.app/mcp
- Step 2: Run GROQCLOUD_LIST_MODELS to fetch valid model IDs
- Step 3: Run GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION with a chosen model and messages
Best Practices
- Always fetch current model IDs via GROQCLOUD_LIST_MODELS before selecting one for chat completions.
- Validate inputs for audio translation (file_path and format) to avoid silent rejections.
- Use GROQCLOUD_GROQ_RETRIEVE_MODEL to understand context windows and features that affect prompts.
- Handle potential nested model lists in GROQCLOUD_LIST_MODELS responses when parsing results.
- Monitor TTS voices with GROQCLOUD_LIST_VOICES and gracefully handle missing or renamed voices.
Example Use Cases
- A customer support bot uses GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION with a live GroqCloud model discovered via GROQCLOUD_LIST_MODELS.
- An analytics dashboard that refreshes available GroqCloud models and presents valid IDs for chat prompts.
- A meeting transcription app translates audio to English using GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION before applying downstream processing.
- A voice-enabled assistant that enumerates TTS voices with GROQCLOUD_LIST_VOICES to select a natural-sounding voice.
- A model catalog page that retrieves model details with GROQCLOUD_GROQ_RETRIEVE_MODEL to surface context window and capabilities.
