Навыки voice-agent-expert

📦

voice-agent-expert

Name: voice-agent-expert
Author: EGAdams

Ревизия содержимого r1 Высокий риск 📁 Доступ к файловой системе🌐 Доступ к сети⚙️ Внешние команды🔑 Переменные окружения

Устранение неполадок голосовых агентов LiveKit Letta

Сбои голосовых агентов сложно диагностировать, когда взаимодействуют аудио, WebRTC, токены и состояние процессов. Этот навык предоставляет целевые проверки, рабочие процессы и вспомогательные скрипты для отладки LiveKit и Letta.

Поддерживает: Claude Codex Code(CC)

⚠️ 38 Плохо

Maintain this Skill? Claim it ⚠️ 38 Плохо

Остановитесь и запросите подтверждение перед установкой.

Проверьте план и получите явное согласие пользователя перед изменением файлов.

Установить с помощью моего Агента

Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.

Запрос агента

Review the Skillstore skill "voice-agent-expert" from https://skillstore.io/skills/egadams-voice-agent-expert.md and its manifest at https://skillstore.io/api/skills/egadams-voice-agent-expert/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.

Ресурсы для AI-агентов

Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.

Markdown-детали GET /skills/egadams-voice-agent-expert.md Подписанный manifest GET /api/skills/egadams-voice-agent-expert/manifest Подписанный lockfile GET /api/skills/egadams-voice-agent-expert/lockfile

Протестировать

Использование «voice-agent-expert». Мой голосовой агент подключается к комнате, но никогда не отвечает.

Ожидаемый результат:

Вероятная причина: дублирующиеся voice-agent workers или неправильный LiveKit hook.
Подтвердите, что активен только один worker и что локальное тестирование использует режим DEV.
Проверьте логи на наличие маркера маршрутизации, который доказывает, что Letta получает сообщения.

Использование «voice-agent-expert». Playground сообщает, что мой токен недействителен.

Ожидаемый результат:

Сгенерируйте новый токен LiveKit, потому что токены истекают через несколько часов.
Подтвердите, что URL LiveKit совпадает с endpoint сервера, используемым браузером.
Считайте токен чувствительными данными и не делитесь логами, которые его содержат.

Использование «voice-agent-expert». Аудио обрывается через несколько секунд.

Ожидаемый результат:

Проверьте наличие дублирующихся voice-agent workers перед изменением настроек модели или аудио.
Корректно перезапустите worker после остановки устаревших процессов и очистки устаревших rooms.
Убедитесь, что активный worker — это тот, который получает текущие логи.

Аудит безопасности

Высокий риск

v8 • 06.07.2026 Открыть версионный отчет

The skill appears intended for local LiveKit and Letta debugging, not covert exfiltration. Several findings are confirmed because helper scripts read .env files, handle API secrets, spawn shell commands, and start local services with hardcoded paths. Many markdown backtick and localhost URL findings are false positives, but the package needs hardening before broad marketplace distribution.

Просканировано файлов

685

Проанализировано строк

Пункты проверки

Ложные срабатывания проигнорированы

Подтверждённые проблемы безопасности (8)

Высокий

scripts/diagnose_voice_system.py:68

Environment file access

livekit_env = Path("/home/adamsl/ottomator-agents/livekit-agent/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/diagnose_voice_system.py:69

Environment file access

planner_env = Path("/home/adamsl/planner/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/diagnose_voice_system.py:111

Environment file access

print("export $(grep -v '^#' /home/adamsl/ottomator-agents/livekit-agent/.env | xargs)")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/generate_token.py:9

Environment file access

env_file = Path("/home/adamsl/ottomator-agents/livekit-agent/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/start_voice_system.py:61

Environment file access

env_file = Path("/home/adamsl/ottomator-agents/livekit-agent/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/start_voice_system.py:71

Environment file access

planner_env = Path("/home/adamsl/planner/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

SKILL.md:35-44 QUICK_REFERENCE.md:124-130

Broad Process Termination Instructions

The reset guidance tells users to kill LiveKit and voice-agent processes before restarting services. Broad process matching can disrupt unrelated local work if run without confirmation.

Both cited sections contain process-kill and restart guidance for local services. The commands are operationally plausible and not merely scanner artifacts.

Средний

scripts/generate_token.py:44-53

Connection Token Printed to Terminal

The token generator creates a LiveKit JWT and prints it directly to terminal output. This is useful for setup but can leak session access through copied logs.

The code directly creates a JWT and prints it under a token label. The behavior is intentional, but the token is still sensitive.

Пункты проверки возможностей (32)

Это реальные локальные возможности, которые могут ожидаться для этого навыка, поэтому они требуют проверки, но не считаются подтверждённым вредоносным поведением.

Высокий

QUICK_REFERENCE.md:133

Hidden file in home directory

## 📝 Aliases (Add to ~/.bashrc)

The skill tells users to add aliases to ~/.bashrc. Shell startup files are persistence points, even though the shown aliases appear benign.

Высокий

QUICK_REFERENCE.md:133

Hidden file access

## 📝 Aliases (Add to ~/.bashrc)

The skill tells users to add aliases to ~/.bashrc. Shell startup files are persistence points, even though the shown aliases appear benign.

Высокий

scripts/diagnose_voice_system.py:11

Python subprocess.run

result = subprocess.run(cmd, shell=True, capture_output=True, text=True)

The helper executes shell command strings with shell=True. Current call sites are mostly fixed, but this is still a command-execution surface.

Высокий

scripts/diagnose_voice_system.py:111

Shell command substitution

print("export $(grep -v '^#' /home/adamsl/ottomator-agents/livekit-agent/.env | xargs)")

The printed export command loads every variable from a .env file through shell substitution. That can expose secrets to the shell environment.

Высокий

scripts/diagnose_voice_system.py:68

Hidden file access

livekit_env = Path("/home/adamsl/ottomator-agents/livekit-agent/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/diagnose_voice_system.py:69

Hidden file access

planner_env = Path("/home/adamsl/planner/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/diagnose_voice_system.py:111

Hidden file access

print("export $(grep -v '^#' /home/adamsl/ottomator-agents/livekit-agent/.env | xargs)")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/diagnose_voice_system.py:72

Generic API/secret keys

livekit_vars = ["LIVEKIT_URL", "LIVEKIT_API_KEY", "LIVEKIT_API_SECRET", "DEEPGRAM_API_KEY"]

The code handles named API keys or secrets for LiveKit, Deepgram, or OpenAI. These values are credentials and require explicit handling safeguards.

Высокий

scripts/diagnose_voice_system.py:81

Generic API/secret keys

if check_env_var(planner_env, "OPENAI_API_KEY") or check_env_var(livekit_env, "OPENAI_API_KEY"):

The code handles named API keys or secrets for LiveKit, Deepgram, or OpenAI. These values are credentials and require explicit handling safeguards.

Высокий

scripts/generate_token.py:9

Hidden file access

env_file = Path("/home/adamsl/ottomator-agents/livekit-agent/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/generate_token.py:16

Python environment access

os.environ.setdefault(key, value)

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/generate_token.py:27

Python environment access

api_key = os.environ.get('LIVEKIT_API_KEY')

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/generate_token.py:28

Python environment access

api_secret = os.environ.get('LIVEKIT_API_SECRET')

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/generate_token.py:27

Generic API/secret keys

api_key = os.environ.get('LIVEKIT_API_KEY')

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/generate_token.py:28

Generic API/secret keys

api_secret = os.environ.get('LIVEKIT_API_SECRET')

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/generate_token.py:31

Generic API/secret keys

if not api_key or not api_secret:

The code handles named API keys or secrets for LiveKit, Deepgram, or OpenAI. These values are credentials and require explicit handling safeguards.

Высокий

scripts/generate_token.py:36

Generic API/secret keys

token = api.AccessToken(api_key, api_secret) \

The code handles named API keys or secrets for LiveKit, Deepgram, or OpenAI. These values are credentials and require explicit handling safeguards.

Высокий

scripts/start_voice_system.py:14

Python subprocess.run

result = subprocess.run(

The startup helper checks ports through shell=True and shell pipelines. The current port values are fixed, but the command-execution pattern remains risky.

Высокий

scripts/start_voice_system.py:95

Python os.exec variants

os.execv(

The script replaces itself with a hardcoded local Python executable and voice-agent file. That starts external code after loading environment secrets.

Высокий

scripts/start_voice_system.py:61

Hidden file access

env_file = Path("/home/adamsl/ottomator-agents/livekit-agent/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/start_voice_system.py:71

Hidden file access

planner_env = Path("/home/adamsl/planner/.env")

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/start_voice_system.py:68

Python environment access

os.environ[key] = value

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

scripts/start_voice_system.py:78

Python environment access

os.environ.setdefault(key, value)

The code references local .env files that can contain API keys and service credentials. Reading or exporting those files is sensitive behavior.

Высокий

SKILL.md:41

Hardcoded IP address

nohup ./livekit-server --dev --bind 0.0.0.0 > /tmp/livekit.log 2>&1 &

The command binds LiveKit to 0.0.0.0, which listens on all interfaces. That can expose a local dev service beyond localhost.

Средний

QUICK_REFERENCE.md:98

Temp directory access

rm -f /tmp/letta_voice_agent.{pid,lock}

The command deletes predictable files under /tmp that are used for PID and lock state. Removing those files can bypass duplicate-process protection.

Средний

scripts/diagnose_voice_system.py:89

Hidden file access

venv_python = "/home/adamsl/planner/.venv/bin/python3"

The script uses a hardcoded hidden virtualenv path to execute local Python code. This is not portable and can run unexpected local binaries.

Средний

scripts/start_voice_system.py:96

Hidden file access

"/home/adamsl/planner/.venv/bin/python3",

The script uses a hardcoded hidden virtualenv path to execute local Python code. This is not portable and can run unexpected local binaries.

Средний

scripts/start_voice_system.py:97

Hidden file access

["/home/adamsl/planner/.venv/bin/python3", LETTA_VOICE_AGENT_EXE, "start"]

The script uses a hardcoded hidden virtualenv path to execute local Python code. This is not portable and can run unexpected local binaries.

Средний

SKILL.md:41

nohup (background persistent process)

nohup ./livekit-server --dev --bind 0.0.0.0 > /tmp/livekit.log 2>&1 &

The reset workflow starts LiveKit as a persistent background process. This can leave a service running after the user expects debugging to end.

Средний

SKILL.md:44

Hidden file access

/home/adamsl/planner/.venv/bin/python3 letta_voice_agent.py dev > /tmp/letta_voice_agent.log 2>&1 &

The package references hidden local paths in commands or configuration. In a marketplace skill, those paths need explicit user review.

Средний

SKILL.md:41

Temp directory access

nohup ./livekit-server --dev --bind 0.0.0.0 > /tmp/livekit.log 2>&1 &

The workflow writes service logs to predictable files under /tmp. Shared temporary paths can create disclosure or tampering risk.

Средний

SKILL.md:44

Temp directory access

/home/adamsl/planner/.venv/bin/python3 letta_voice_agent.py dev > /tmp/letta_voice_agent.log 2>&1 &

The workflow writes service logs to predictable files under /tmp. Shared temporary paths can create disclosure or tampering risk.

Факторы риска

📁 Доступ к файловой системе (32)

🌐 Доступ к сети (6)

README.md:48 scripts/generate_token.py:57 scripts/start_voice_system.py:85 SKILL.md:53 SKILL.md:41 SKILL.md:74

⚙️ Внешние команды (22)

🔑 Переменные окружения (16)

Аудитор:: codex Посмотреть историю аудитов →

Поделиться и цитировать этот отчет

Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.

Открыть версионный отчет

Копировать ссылку на отчёт

https://skillstore.io/skills/egadams-voice-agent-expert/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Значок Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/egadams-voice-agent-expert/security.svg)](https://skillstore.io/skills/egadams-voice-agent-expert?utm_source=security_passport_badge)

Значок HTML

<a href="https://skillstore.io/skills/egadams-voice-agent-expert?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/egadams-voice-agent-expert/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Встраиваемая карточка

<iframe src="https://skillstore.io/embed/skills/egadams-voice-agent-expert.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Академические ссылки (APA · BibTeX · CFF)

Цитата APA

EGAdams. (2026). voice-agent-expert security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/egadams-voice-agent-expert/audits/8

Цитата BibTeX

@techreport{egadams-egadams-voice-agent-expert-2026,
  author = {EGAdams},
  title = {voice-agent-expert security audit report (audit version 8)},
  institution = {Skillstore},
  year = {2026},
  number = {8},
  url = {https://skillstore.io/skills/egadams-voice-agent-expert/audits/8},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "voice-agent-expert security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
  - name: "EGAdams"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/egadams-voice-agent-expert/audits/8"
identifiers:
  - type: other
    value: "skillstore:egadams-voice-agent-expert:audit:8"
    description: "Skillstore immutable audit report identifier"

Оценка Skillstore

Почему такая оценка Достоверность доказательств: Средний

Архитектура

Сопровождаемость

Контент

Сообщество

Соответствие спецификации

Что вы можете построить

Исправить локальную настройку голосового чата

Диагностировать, почему локальная голосовая сессия LiveKit и Letta не подключается или не отвечает.

Отладить обрывы аудио

Связать периодические сбои аудио с дублирующимися workers, устаревшими rooms или неправильным режимом агента.

Подготовить runbooks для поддержки

Преобразовать повторяющиеся сбои LiveKit и Letta в воспроизводимые проверки и шаги эскалации.

Попробуйте эти промпты

Диагностировать сбой подключения

Мой голосовой агент LiveKit и Letta не подключается. Сначала запроси ошибку, затем проведи меня через самые безопасные проверки.

Выбрать правильный режим агента

Объясни, следует ли мне использовать режим START или режим DEV для локального голосового чата, и перечисли симптомы выбора неправильного режима.

Исследовать дублирующиеся workers

Помоги мне определить, вызывают ли дублирующиеся voice-agent workers или устаревшие LiveKit rooms обрывы аудио.

Спроектировать более безопасный процесс запуска

Проверь мой локальный процесс запуска LiveKit и Letta на риски безопасности, обработку секретов и более безопасное управление процессами.

Лучшие практики

Проверяйте каждую команду перед запуском против локальных сервисов или shell startup files.
Вынесите жестко заданные пути в конфигурацию перед распространением этого рабочего процесса на другие машины.
Считайте сгенерированные токены LiveKit и содержимое .env конфиденциальными учетными данными.

Избегать

Не запускайте широкие команды завершения процессов без подтверждения совпадающих процессов.
Не привязывайте локальные сервисы разработки ко всем интерфейсам без сетевых ограничений.
Не вставляйте сгенерированные токены или вывод, полученный из .env, в публичные issue reports.