bot-developer — скилл для Claude Code: боты и установка
Скилл bot-developer для Claude Code помогает проектировать ботов для Discord, Telegram и Slack — от обработки событий до ограничений запросов и модерации. Описывает чат-ботов с диалогами в несколько ходов.
MIT 218 установок ★ 274 обновлён 2026-10-30
npx skills add curiositech/some_claude_skills --skill bot-developer -a claude-codeЧто делает bot-developer
Скилл описывает архитектуру ботов с обработкой событий, очередями сообщений и отдельными сервисами для пользователей и модерации. Для диалогов предлагает конечные автоматы, сохранение контекста и сброс состояния после бездействия. Есть рекомендации по лимитам запросов с Redis и учёту заголовков API.
Для модерации предусмотрены система баллов с повышением санкций, их постепенное затухание и правила против спама, ссылок и запрещённых слов. Также разбираются проверки прав, защита токенов и валидация ввода. Состояние только в памяти Python теряется при перезапуске, поэтому скилл рекомендует Redis для состояния и PostgreSQL для хранения данных.
В комплекте есть справочные материалы по архитектуре, лимитам, модерации и шаблонам для Discord.py и Telegram webhook. Для Telegram в production рекомендуются webhooks вместо long polling; это важно учесть при выборе способа подключения.
Какие задачи решает
- спроектировать обработку событий для Discord-бота
- сохранить состояние диалога между сообщениями
- ограничить запросы к API с учётом заголовков
- настроить автоматическую модерацию спама и ссылок
- проверять права перед выполнением команд
Примеры запросов агенту
- Спроектируй Discord-бота для модерации спама и ссылок.
- Добавь в Telegram-бота диалог в несколько шагов с сохранением контекста.
- Проверь обработчики Slack-бота на лимиты запросов и проверки прав.
Как установить bot-developer
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill bot-developer -a claude-code2Вручную: положить файлы
~/.claude/skills/bot-developer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/bot-developer/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill bot-developer -a codex2Вручную: положить файлы
.agents/skills/bot-developer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill bot-developer -a cursor2Вручную: положить файлы
.cursor/skills/bot-developer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install curiositech/some_claude_skills .claude/skills/bot-developer2Вручную: положить файлы
.github/skills/bot-developer/SKILL.md1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill bot-developer -a gemini-cli2Командой платформы
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/bot-developerВручную: положить файлы
.devin/skills/bot-developer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill bot-developer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о bot-developer
Как установить bot-developer в Claude Code?
Выполните npx skills add curiositech/some_claude_skills --skill bot-developer -a claude-code. Файл скилла появится в ~/.claude/skills/bot-developer/SKILL.md.
Что делает bot-developer?
Помогает разрабатывать ботов для Discord, Telegram и Slack: проектировать диалоги, модерацию и ограничение запросов к API.
Как bot-developer предлагает хранить состояние бота?
Для состояния диалогов скилл рекомендует Redis, а для постоянных данных — PostgreSQL. Словарь Python в памяти теряет состояние при перезапуске.
Исходный текст
SKILL.md · MIT
---
name: bot-developer
description: Expert bot developer specializing in Discord, Telegram, Slack automation with deep knowledge of rate limiting, state machines, event sourcing, moderation systems, and conversational AI integration.
Activate on 'Discord bot', 'Telegram bot', 'Slack bot', 'chat automation', 'moderation system'. NOT for web APIs (use backend-architect), general automation scripts (use python-pro), or frontend chat
widgets (use frontend-developer).
allowed-tools: Read,Write,Edit,Bash,WebSearch,WebFetch
metadata:
category: AI & Machine Learning
pairs-with:
- skill: api-architect
reason: Design robust bot backend APIs
- skill: devops-automator
reason: Deploy and scale bot infrastructure
tags:
- discord
- telegram
- slack
- bots
- automation
---
# Bot Developer
Expert in building production-grade bots with proper architecture, state management, and scalability.
## Quick Start
```
User: "Build a Discord moderation bot with auto-mod"
Bot Developer:
1. Set up event-driven architecture (message broker + service layer)
2. Implement state machine for multi-turn mod flows
3. Add distributed rate limiting (Redis)
4. Create point-based moderation with decay
5. Configure auto-mod rules (spam, caps, links, words)
6. Deploy with proper logging and error handling
```
**Key principle**: Production bots need rate limiting, state management, and graceful degradation—not just command handlers.
## Core Capabilities
### 1. Platform Expertise
| Platform | Connection | Best For |
|----------|------------|----------|
| Discord | Gateway (WebSocket) | Gaming communities, large servers |
| Telegram | Webhook (production) | International, groups/channels |
| Slack | Socket Mode/Webhook | Workplace, integrations |
### 2. Production Architecture
- Event-driven design with message broker (Redis Streams / RabbitMQ)
- Service layer separation (User, Moderation, Economy, Integration)
- PostgreSQL + Redis + S3 data layer
- Cog-based modular structure
### 3. State Management
- Finite state machines for multi-turn conversations
- Timeout handling (auto-reset after inactivity)
- Race condition prevention
- Context preservation across turns
### 4. Rate Limiting
- Distributed limiter with Redis backend
- Adaptive limiter responding to API headers
- Per-user, per-guild, and global buckets
- Graceful degradation with retry-after info
### 5. Moderation System
- Point-based escalation (configurable thresholds)
- Automatic decay over time
- Auto-mod rules (spam, caps, links, banned words)
- Fuzzy matching to catch bypass attempts (l33t speak)
- Audit logging for compliance
## Escalation Thresholds
| Points | Action |
|--------|--------|
| 0-2 | No action |
| 3-5 | Mute |
| 6-9 | Kick |
| 10-14 | Temp Ban |
| 15+ | Permanent Ban |
## Auto-Mod Rules
| Rule | Detection Method |
|------|-----------------|
| Spam | Message frequency per sliding window |
| Caps | Character ratio (>70% uppercase) |
| Links | URL regex + domain whitelist |
| Words | Dictionary + Levenshtein (85% threshold) |
| Mentions | @mention counting with variants |
| Invites | Discord invite regex + URL expansion |
## When to Use
**Use for:**
- Discord/Telegram/Slack bot development
- Moderation and auto-mod systems
- Multi-turn conversational flows
- Economy/XP/leveling systems
- Integration with external APIs
**Do NOT use for:**
- Web APIs without chat interface (use backend-architect)
- General automation scripts (use python-pro)
- Frontend chat widgets (use frontend-developer)
- AI/ML model integration alone (use ai-engineer)
## Anti-Patterns
### Anti-Pattern: Polling in Production
**What it looks like**: Using `bot.polling()` or long-polling for Telegram
**Why wrong**: Wastes resources, slower response, can't scale
**Instead**: Use webhooks with proper verification
### Anti-Pattern: No Rate Limiting
**What it looks like**: Sending API requests without throttling
**Why wrong**: Gets bot banned, triggers 429s, poor UX
**Instead**: Implement adaptive rate limiter respecting API headers
### Anti-Pattern: In-Memory State Only
**What it looks like**: Storing conversation state in Python dict
**Why wrong**: Lost on restart, can't scale to multiple instances
**Instead**: Redis for state, PostgreSQL for persistence
### Anti-Pattern: Blocking Event Handlers
**What it looks like**: Long-running operations in `on_message`
**Why wrong**: Blocks all other events, causes timeouts
**Instead**: Async tasks, message queue for heavy work
## Security Checklist
```
TOKEN SECURITY
├── Never commit tokens to git
├── Use environment variables or secret manager
├── Rotate tokens if exposed
└── Separate tokens for dev/staging/prod
PERMISSION CHECKS
├── Verify user permissions before action
├── Use platform's permission system
├── Check bot's permissions before attempting
└── Fail safely if permissions missing
INPUT VALIDATION
├── Sanitize all user input
├── Validate command arguments
├── Parameterized queries (no SQL injection)
└── Rate limit user-triggered actions
```
## Reference Files
- `references/architecture-patterns.md` - Event-driven architecture, state machines
- `references/rate-limiting.md` - Distributed and adaptive rate limiting
- `references/moderation-system.md` - Point-based moderation, auto-mod
- `references/platform-templates.md` - Discord.py, Telegram webhook templates, security
---
**Core insight**: Production bots fail from rate limiting and state bugs, not from bad command logic. Build infrastructure first.
**Use with**: ai-engineer (LLM integration) | backend-architect (API design) | deployment-engineer (hosting)
© curiositech · MIT · curiositech/some_claude_skills