스킬 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 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.

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 워커 또는 잘못된 LiveKit hook.
하나의 워커만 활성 상태인지, 로컬 테스트가 DEV 모드를 사용하는지 확인하세요.
Letta가 메시지를 수신하고 있음을 증명하는 라우팅 마커가 로그에 있는지 확인하세요.

"voice-agent-expert" 사용 중입니다. playground에서 내 토큰이 유효하지 않다고 표시됩니다.

예상 결과:

토큰은 몇 시간 후 만료되므로 새 LiveKit 토큰을 생성하세요.
LiveKit URL이 브라우저에서 사용하는 서버 엔드포인트와 일치하는지 확인하세요.
토큰을 민감 정보로 취급하고 토큰이 포함된 로그를 공유하지 마세요.

"voice-agent-expert" 사용 중입니다. 몇 초 후 오디오가 끊깁니다.

예상 결과:

모델이나 오디오 설정을 변경하기 전에 중복 voice-agent 워커가 있는지 확인하세요.
오래된 프로세스를 중지하고 오래된 룸을 정리한 뒤 워커를 깨끗하게 다시 시작하세요.
활성 워커가 현재 로그를 수신하는 워커인지 확인하세요.

보안 감사

높은 위험

v8 • 2026. 7. 6. 버전별 보고서 열기

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 음성 세션이 연결되지 않거나 응답하지 않는 이유를 진단합니다.

오디오 끊김 디버깅

간헐적인 오디오 오류를 중복 워커, 오래된 룸, 잘못된 에이전트 모드까지 추적합니다.

지원 런북 준비

반복되는 LiveKit 및 Letta 오류를 재현 가능한 점검 항목과 에스컬레이션 단계로 전환합니다.

이 프롬프트를 사용해 보세요

연결 실패 진단

내 LiveKit 및 Letta 음성 에이전트가 연결되지 않습니다. 먼저 오류를 물어본 다음, 가장 안전한 점검부터 안내해 주세요.

올바른 에이전트 모드 선택

로컬 음성 채팅에 START 모드와 DEV 모드 중 무엇을 사용해야 하는지 설명하고, 잘못된 모드를 선택했을 때 나타나는 증상을 나열해 주세요.

중복 워커 조사

중복 voice-agent 워커나 오래된 LiveKit 룸이 오디오 끊김을 유발하는지 확인할 수 있도록 도와주세요.

더 안전한 시작 워크플로 설계

보안 위험, 시크릿 처리, 더 안전한 프로세스 관리 관점에서 내 로컬 LiveKit 및 Letta 시작 워크플로를 검토해 주세요.

모범 사례

로컬 서비스나 shell startup 파일에 대해 실행하기 전에 모든 명령을 검토하세요.
이 워크플로를 여러 머신에서 공유하기 전에 하드코딩된 경로를 구성으로 옮기세요.
생성된 LiveKit 토큰과 .env 내용을 민감한 자격 증명으로 취급하세요.

피하기

일치하는 프로세스를 확인하지 않고 광범위한 process-kill 명령을 실행하지 마세요.
네트워크 제어 없이 로컬 개발 서비스를 모든 인터페이스에 바인딩하지 마세요.
생성된 토큰이나 .env에서 파생된 출력을 공개 이슈 보고서에 붙여넣지 마세요.

자주 묻는 질문

이 스킬은 어떤 시스템을 대상으로 하나요?

로컬 LiveKit 및 Letta 음성 에이전트 개발과 문제 해결을 대상으로 합니다.

이 스킬이 명령을 자동으로 실행하나요?

스크립트와 명령 안내를 포함합니다. 사용자는 실행 전에 명령을 검토해야 합니다.

LiveKit 토큰을 생성할 수 있나요?

예. 토큰 스크립트는 LiveKit 자격 증명을 읽고 연결 토큰을 출력합니다.

프로덕션 배포에 바로 사용할 수 있나요?

아니요. 로컬 디버깅 참고 자료이며 프로덕션 강화 지침이 없습니다.

중복 프로세스가 왜 중요한가요?

중복 워커는 동일한 오디오 스트림을 두고 경쟁하여 타임아웃이나 끊김을 만들 수 있습니다.

감사에서 위험이 표시되는 이유는 무엇인가요?

이 패키지는 .env 파일을 읽고, API 시크릿을 처리하며, 프로세스를 시작하고, 하드코딩된 경로를 사용합니다.

개발자 세부 정보

작성자

EGAdams

라이선스

MIT

Skillstore 리비전

버전 안내

작성자가 버전을 선언하지 않았습니다.

리포지토리

https://github.com/EGAdams/planner/tree/main/.claude/skills/voice-agent-expert

참조

72d5025b022c77f7a51bdf5c1637c689c80e89d1

유지보수 최신성

2026. 7. 25.

사용량

4 다운로드 · 177 조회

파일 구조

📁 scripts/

📄 diagnose_voice_system.py

📄 generate_token.py

📄 start_voice_system.py

📄 QUICK_REFERENCE.md

📄 README.md

📄 SKILL.md