Agent skill

Voice

by alsk1992 in alsk1992/CloddsBot

Voice recognition, wake words, and voice-controlled trading. An agent skill from alsk1992/CloddsBot.

MITAuto-check passedMedia & Creative

Install Voice

skills CLI
$ npx skills add alsk1992/CloddsBot --skill voice -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alsk1992/CloddsBot voice --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alsk1992/CloddsBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/bundled/voice .claude/skills/voice && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
voice
GitHub stars
2.9k
Token cost
~1.1k tokens
SKILL.md length
142 words
Files
2
Skills in repo
116
Repo updated
First seen
Licence
MIT

At a glance

Voice recognition, wake words, and voice-controlled trading. An agent skill from alsk1992/CloddsBot.

  • Works in 5 steps: Quiet environment — Background noise… → Clear speech — Speak clearly for best… → Short commands — Keep voice commands… → …
  • Tasks that involve Trading and backtesting
  • SKILL.md covers Chat Commands, TypeScript API Reference, Wake Word Configuration and STT Providers, plus 3 more sections
  • Runs TypeScript scripts from its folder

What it does

Voice is an agent skill from alsk1992/CloddsBot. Voice recognition, wake words, and voice-controlled trading

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `index.ts`).

It sits in Media & Creative, covering Trading and backtesting and Text to speech and voice. The repository describes itself as: Open Source AI trading agent that operates autonomously across 1000+ markets - Polymarket, Kalshi, Binance, Hyperliquid, Solana DEXs, 5 EVM chains. Scans for edge, executes… The licence is MIT.

When your agent uses it

  • Tasks that involve Trading and backtesting
  • Tasks that involve Text to speech and voice

Example prompts

  • “/voice”

Requirements

  • Node.js
  • A credential in OPENAI_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Quiet environment — Background noise affects accuracy
  2. Clear speech — Speak clearly for best recognition
  3. Short commands — Keep voice commands concise
  4. Confirmation — Enable confirmations for trades
  5. Fallback — Text input always available

What it can do on your machine

Read from SKILL.md and the folder at commit c930628. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Voice loads about 1.1k tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 142 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~16
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alsk1992/CloddsBot at commit c930628, republished under its MIT licence (© alsk1992). 142 words, ~1,122 tokens.

Download SKILL.mdSave it as .claude/skills/voice/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
voice
description
Voice recognition, wake words, and voice-controlled trading
emoji
🎤

Voice - Complete API Reference

Voice-controlled interface with wake word detection, speech-to-text, and text-to-speech.


Chat Commands

Voice Control
/voice start                                Start voice listening
/voice stop                                 Stop voice listening
/voice status                               Check voice status
/voice wake "hey clodds"                    Set wake word
Settings
/voice language en-US                       Set language
/voice sensitivity high                     Wake word sensitivity
/voice timeout 30                           Silence timeout (seconds)
/voice continuous on                        Enable continuous mode

TypeScript API Reference

Create Voice Assistant
typescript
import { createVoiceAssistant } from 'clodds/voice';

const voice = createVoiceAssistant({
  // Wake word
  wakeWord: 'hey clodds',
  wakeWordSensitivity: 0.5,  // 0-1

  // Speech-to-text
  stt: {
    provider: 'whisper',  // 'whisper' | 'vosk' | 'google'
    model: 'base',        // 'tiny' | 'base' | 'small' | 'medium' | 'large'
    language: 'en',
  },

  // Text-to-speech
  tts: {
    provider: 'elevenlabs',  // 'elevenlabs' | 'say' | 'espeak'
    voice: 'rachel',
    speed: 1.0,
  },

  // Timeouts
  silenceTimeoutMs: 3000,
  maxRecordingMs: 30000,
});
Start/Stop Listening
typescript
// Start listening for wake word
await voice.start();

// Check if listening
const isListening = voice.isListening();

// Stop listening
await voice.stop();
Event Handlers
typescript
// Wake word detected
voice.on('wake', () => {
  console.log('Wake word detected!');
});

// Speech recognized
voice.on('speech', (text: string) => {
  console.log(`User said: ${text}`);
});

// Transcription complete
voice.on('transcript', (result) => {
  console.log(`Final: ${result.text}`);
  console.log(`Confidence: ${result.confidence}`);
  console.log(`Duration: ${result.durationMs}ms`);
});

// Error handling
voice.on('error', (error) => {
  console.error('Voice error:', error);
});

// Silence detected
voice.on('silence', () => {
  console.log('User stopped speaking');
});
Speak (TTS)
typescript
// Speak text
await voice.speak('Your order has been placed');

// Speak with options
await voice.speak('Market is up 5%', {
  voice: 'josh',
  speed: 1.2,
  pitch: 1.0,
});

// Cancel speaking
voice.cancelSpeech();
Manual Transcription
typescript
// Transcribe audio buffer
const result = await voice.transcribe(audioBuffer, {
  language: 'en',
  prompt: 'Trading commands',  // Context hint
});

console.log(`Text: ${result.text}`);
console.log(`Language: ${result.language}`);
Voice Activity Detection
typescript
// Check if user is speaking
const vad = voice.getVAD();

vad.on('speechStart', () => {
  console.log('User started speaking');
});

vad.on('speechEnd', (audio) => {
  console.log('User stopped speaking');
  // audio contains the recorded speech
});

Wake Word Configuration

SettingValuesDescription
wakeWordAny phraseTrigger phrase
sensitivity0.0 - 1.0Detection threshold

Built-in wake words:

  • "hey clodds"
  • "okay clodds"
  • "clodds"

STT Providers

ProviderQualitySpeedOffline
WhisperExcellentMediumYes
VoskGoodFastYes
GoogleExcellentFastNo

TTS Providers

ProviderQualityVoicesAPI Key
ElevenLabsPremium30+Required
say (macOS)GoodSystemNone
espeakBasicManyNone

Voice Commands Examples

Once voice is active, speak naturally:

"Hey Clodds, what's my portfolio value?"
"Hey Clodds, buy 100 dollars of Trump YES"
"Hey Clodds, what are the top arbitrage opportunities?"
"Hey Clodds, set a price alert for Bitcoin at 100k"

Best Practices

  1. Quiet environment — Background noise affects accuracy
  2. Clear speech — Speak clearly for best recognition
  3. Short commands — Keep voice commands concise
  4. Confirmation — Enable confirmations for trades
  5. Fallback — Text input always available

© alsk1992, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in src/skills/bundled/voice of alsk1992/CloddsBot.

  • SKILL.md
  • index.ts

Open the folder on GitHubat commit c930628

Compare with similar skills

Voice next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Voice compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Voice this skillalsk1992/CloddsBot2.9k—~1.1kAutomated safety check: PassMIT
Senpi WhySenpi-ai/senpi-skills134—~2.5kAutomated safety check: PassApache-2.0
Gmgn Wallet ReviewGMGNAI/gmgn-skills607—~8.2kAutomated safety check: NotesMIT
Gmgn Wallet StyleGMGNAI/gmgn-skills607—~7.1kAutomated safety check: PassMIT
Tushare Datazillionare/zillionare3212 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Senpi Why

    Senpi-ai/senpi-skills

    Answer "what makes Senpi different?" / "why Senpi?" / "Senpi vs other trading apps, bots or AI chatbots?" — the positioning answer, led by value, not a feature dump.

    134 GitHub stars~2.5k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Gmgn Wallet Review

    GMGNAI/gmgn-skills

    A short trading portrait of ONE wallet address — a single style tag (磨损户 / P小将 / 印钞机 … plus a speed subtitle), one sentence recapping its record and one sentence of next-step advice, for 1D / 7D /…

    607 GitHub stars~8.2k tokensUpdated 10 days ago
    Media & CreativeAuto-check: notes
  • Gmgn Wallet Style

    GMGNAI/gmgn-skills

    Tag any wallet's trading style — one main title from a 20-cell frequency×P&L grid (印钞机, 磨损户, P小将, 一击必杀, and 16 others), one holding-speed subtitle (秒杀流/日内流/波段流/长持流), and any of 14 orthogonal badges…

    607 GitHub stars~7.1k tokensUpdated 10 days ago
    Media & CreativeAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    321 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    5k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    875 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed

More from alsk1992/CloddsBot

All 116 skills in this repo
  • Qmd

    alsk1992/CloddsBot

    Local hybrid search for markdown notes and docs. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub starsUsed in 3 repos~1.2k tokens
    Auto-check passed
  • AI Strategy

    alsk1992/CloddsBot

    AI Strategy - natural language to trades. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub stars~670 tokensUpdated 6 days ago
    Auto-check passed
  • Alerts

    alsk1992/CloddsBot

    Create and manage price alerts for prediction markets. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub stars~460 tokensUpdated 6 days ago
    Auto-check passed
  • Analytics

    alsk1992/CloddsBot

    Performance attribution, trade analytics, and strategy optimization

    2.9k GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • Arbitrage

    alsk1992/CloddsBot

    Automated cross-platform arbitrage detection and monitoring. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub stars~1.7k tokensUpdated 6 days ago
    Auto-check passed
  • Auto Reply

    alsk1992/CloddsBot

    Automatic response rules, patterns, and scheduled messages. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed

Questions about Voice

What does Voice do?

Voice recognition, wake words, and voice-controlled trading. An agent skill from alsk1992/CloddsBot. Voice is an agent skill from alsk1992/CloddsBot.

When should I use Voice?

Voice fits situations like: tasks that involve Trading and backtesting; tasks that involve Text to speech and voice.

How do I install Voice in Claude Code?

Run `npx skills add alsk1992/CloddsBot --skill voice -a claude-code`. Or copy the skill folder (src/skills/bundled/voice in alsk1992/CloddsBot) into .claude/skills/voice in your project. Claude Code loads it when a task matches its description.

How do I install Voice in Codex?

Run `npx skills add alsk1992/CloddsBot --skill voice -a codex`. Or copy the skill folder (src/skills/bundled/voice in alsk1992/CloddsBot) into .agents/skills/voice in your project. Codex loads it when a task matches its description.

Can I use Voice in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alsk1992/CloddsBot --skill voice -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/voice, .gemini/skills/voice, .github/skills/voice and .opencode/skills/voice in your project.

What does Voice need to run?

Going by SKILL.md and its folder, Voice needs TypeScript for the scripts in its folder. Our summary lists: Node.js; A credential in OPENAI_API_KEY.

Does Voice access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Voice safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Voice use?

Voice is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Voice use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Voice?

Skills that share tags, products or a category with Voice: Senpi Why (Senpi-ai/senpi-skills, 134 stars), Gmgn Wallet Review (GMGNAI/gmgn-skills, 607 stars), Gmgn Wallet Style (GMGNAI/gmgn-skills, 607 stars) and Tushare Data (zillionare/zillionare, 321 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Voice?

alsk1992 (a GitHub user) maintains it in alsk1992/CloddsBot, which has 2,933 GitHub stars. The repository holds 116 skills in this directory. The repository was last updated on October 2, 2026.

Source: alsk1992/CloddsBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.