Skip to content

Update 2026-01-26-echokit-day-26-claude-config-skill.md #133

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
alabulei1 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update 2026-01-26-echokit-day-26-claude-config-skill.md #133

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 29 additions & 29 deletions doc/dev/2026-01-26-echokit-day-26-claude-config-skill.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,37 +1,37 @@
---
slug: echokit-30-days-day-26-claude-config-skill
title: "Day 26: Generate config.toml with Claude Code Skills | The First 30 Days with EchoKit"
title: "Day 26: Generate config.toml with Claude Code SKILLs | The First 30 Days with EchoKit"
tags: [echokit30days, claude-code, configuration]
---

Over the first 25 days of this series, we've configured EchoKit by manually editing `config.toml` files. That works fine for tweaks, but it's tedious when you're setting up EchoKit for the first time or trying a completely different configuration.

**Today, we're introducing a faster way: the EchoKit Config Generator skill for Claude Code.**
**Today, we're introducing a faster way: the EchoKit Config Generator SKILL for Claude Code.**

This skill automates the entire setup process through an interactive conversation—no manual TOML editing required.
This SKILL automates the entire setup process through an interactive conversation—no manual TOML editing required.

**Watch the skill in action:**
**Watch the SKILL in action:**

<iframe width="560" height="315" src="https://www.youtube.com/embed/kx9VtZ0-12M" title="EchoKit Config Generator Skill Demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
<iframe width="560" height="315" src="https://www.youtube.com/embed/kx9VtZ0-12M" title="EchoKit Config Generator SKILL Demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

## What Are Claude Code Skills?
## What Are Claude Code SKILLs?

Claude Code "skills" are reusable prompts that live in `.claude/skills/` directories. Think of them as mini-programs written in natural language. Instead of explaining what you want every time, you trigger a skill, and it guides the AI through a structured workflow.
Claude Code "SKILLs" are reusable prompts that live in `.claude/SKILLs/` directories. Think of them as mini-programs written in natural language. Instead of explaining what you want every time, you trigger a SKILL, and it guides the AI through a structured workflow.

**Why do we need Claude Code skill for EchoKit?**
**Why do we need Claude Code SKILL for EchoKit?**

Setting up an EchoKit server involves many steps: writing TOML configuration, understanding platform-specific field names, collecting API keys, building the server, finding your IP address, and launching with the right commands. For beginners, this can be overwhelming. Even experienced users can forget details like which section comes first, or whether ElevenLabs uses `api_key` or `token`.

The EchoKit Config Generator skill solves this by turning setup into a conversation. More importantly, **it teaches you how to configure EchoKit server** along the way. As you answer questions, you learn:
The EchoKit Config Generator SKILL solves this by turning setup into a conversation. More importantly, **it teaches you how to configure EchoKit server** along the way. As you answer questions, you learn:
- **How to set up EchoKit server** — What goes into `config.toml` and why
- **How to run EchoKit server** — The `cargo build --release` command, launching with debug logging
- **How to get your IP address** — The skill shows you exactly how to find your actual local IP (not localhost) and construct the WebSocket URL
- **How to get your IP address** — The SKILL shows you exactly how to find your actual local IP (not localhost) and construct the WebSocket URL

Unlike documentation that you read once and forget, the skill guides you through each step interactively. You see the config being generated, understand what each field does, and learn the workflow by doing it—while the skill handles the technical details for you.
Unlike documentation that you read once and forget, the SKILL guides you through each step interactively. You see the config being generated, understand what each field does, and learn the workflow by doing it—while the SKILL handles the technical details for you.

The EchoKit Config Generator skill comes bundled with the `echokit_server` repository. Just clone the repo, and Claude Code discovers it automatically.
The EchoKit Config Generator SKILL comes bundled with the `echokit_server` repository. Just clone the repo, and Claude Code discovers it automatically.

## Installing the Skill
## Installing the SKILL

First, clone the echokit_server repository:

Expand All @@ -40,45 +40,45 @@ git clone https://github.com/second-state/echokit_server.git
cd echokit_server
```

That's it. Claude Code automatically discovers skills in `.claude/skills/` directories within your workspace. No additional installation required.
That's it. Claude Code automatically discovers SKILLs in `.claude/SKILLs/` directories within your workspace. No additional installation required.

## Using the Skill
## Using the SKILL

In Claude Code, simply say: *"Generate an EchoKit config for a coding assistant"*

The skill guides you through a 5-phase process:
The SKILL guides you through a 5-phase process:

**Phase 1: Describe Your Assistant** — Answer 7 questions about purpose, tone, capabilities, response style, domain knowledge, constraints, and preferences. The skill generates a sophisticated system prompt from your answers.
**Phase 1: Describe Your Assistant** — Answer 7 questions about purpose, tone, capabilities, response style, domain knowledge, constraints, and preferences. The SKILL generates a sophisticated system prompt from your answers.

**Phase 2: Choose Platforms** — For each service (ASR, TTS, LLM), select from pre-configured options or choose "Custom" to specify any platform. The skill auto-discovers API documentation via web search for custom platforms.
**Phase 2: Choose Platforms** — For each service (ASR, TTS, LLM), select from pre-configured options or choose "Custom" to specify any platform. The SKILL auto-discovers API documentation via web search for custom platforms.

**Phase 3: MCP Server** — Optionally add an MCP server by providing the URL.

**Phase 4: Preview and Generate** — Review your complete `config.toml`, confirm it's correct, and the skill writes both `config.toml` and `SETUP_GUIDE.md` to your chosen directory.
**Phase 4: Preview and Generate** — Review your complete `config.toml`, confirm it's correct, and the SKILL writes both `config.toml` and `SETUP_GUIDE.md` to your chosen directory.

**Phase 5: API Keys and Launch** — The skill shows where to get API keys, collects them from you, updates `config.toml`, builds the server with `cargo build --release`, and launches it with debug logging enabled. When the server starts, the skill automatically detects your local IP address and displays the WebSocket URL ready for you to connect.
**Phase 5: API Keys and Launch** — The SKILL shows where to get API keys, collects them from you, updates `config.toml`, builds the server with `cargo build --release`, and launches it with debug logging enabled. When the server starts, the SKILL automatically detects your local IP address and displays the WebSocket URL ready for you to connect.

From zero to running EchoKit in one conversation.

## Why This Matters

The Config Generator offers several advantages:

**Faster Setup** — Answer questions instead of reading docs and writing TOML manually. The skill handles syntax, field names, and structure automatically.
**Faster Setup** — Answer questions instead of reading docs and writing TOML manually. The SKILL handles syntax, field names, and structure automatically.

**Fewer Errors** — No more wrong field names, incorrect section order, or missing fields. The skill knows platform-specific details like ElevenLabs using `token` instead of `api_key`.
**Fewer Errors** — No more wrong field names, incorrect section order, or missing fields. The SKILL knows platform-specific details like ElevenLabs using `token` instead of `api_key`.

**Custom Platform Discovery** — Want to use a new LLM provider? The skill searches the web for API documentation and confirms with you. Groq, DeepSeek, Mistral, Together—all auto-discovered.
**Custom Platform Discovery** — Want to use a new LLM provider? The SKILL searches the web for API documentation and confirms with you. Groq, DeepSeek, Mistral, Together—all auto-discovered.

**Rich System Prompts** — The 7-question phase generates sophisticated system prompts tailored to your use case, saving you time crafting them manually.

**Complete Workflow** — It doesn't just generate a config. It collects API keys, builds the server, launches it, and even detects your local IP address. You get a ready-to-use WebSocket URL—no manual IP lookup required.

**Ready Connection Details** — After launching, the skill automatically finds your actual local IP address (not localhost) and displays the complete WebSocket URL. Just copy and paste it into your EchoKit device to connect.
**Ready Connection Details** — After launching, the SKILL automatically finds your actual local IP address (not localhost) and displays the complete WebSocket URL. Just copy and paste it into your EchoKit device to connect.

## When to Use the Skill vs. Manual Configuration
## When to Use the SKILL vs. Manual Configuration

| Use the Skill When | Use Manual Config When |
| Use the SKILL When | Use Manual Config When |
|-------------------|----------------------|
| First-time EchoKit setup | Quick API key changes |
| Learning how EchoKit server works | Adjusting `history` value |
Expand All @@ -87,7 +87,7 @@ The Config Generator offers several advantages:
| Exploring custom platforms | Scripting deployments |
| Understanding the complete workflow | You know exactly what you need |

Both approaches are valid. The skill is also a learning tool—it guides you through each step while explaining what's happening, so you understand the setup process deeply. Manual editing provides precision control once you're familiar with the configuration.
Both approaches are valid. The SKILL is also a learning tool—it guides you through each step while explaining what's happening, so you understand the setup process deeply. Manual editing provides precision control once you're familiar with the configuration.

## Supported Platforms

Expand All @@ -100,7 +100,7 @@ Both approaches are valid. The skill is also a learning tool—it guides you thr
- Any OpenAI-compatible LLM: Groq, DeepSeek, Mistral, Together, and more
- Any platform with documented APIs

Choose "Custom" and the skill finds the rest.
Choose "Custom" and the SKILL finds the rest.

## What's Next: Day 27

Expand All @@ -112,7 +112,7 @@ But what happens when you want to share your EchoKit setup with others? Or deplo

---

Ready to try the Config Generator skill or share your own configurations?
Ready to try the Config Generator SKILL or share your own configurations?

* Join the **[EchoKit Discord](https://discord.gg/Fwe3zsT5g3)**

Expand Down
Loading