에이전트 스킬 연결 - Typecast Documentation

CLI는 에이전트 스킬 안에서 쓰기 좋습니다. 타입캐스트 음성 생성을 셸 명령으로 노출하기 때문에, 에이전트가 텍스트를 작성하고 파일명을 정하고 cast를 호출해 재생 가능한 오디오 자산을 만들 수 있습니다.

스킬 지시문 템플릿

# 타입캐스트 음성 생성 스킬

사용자가 보이스오버, 내레이션, 대사, 오디오 미리듣기를 요청하면 CLI를 사용합니다.

Rules:
- Never expose the API key.
- Prefer `--out` so generated audio is saved as a file.
- Use descriptive filenames.
- Use `--emotion smart` for natural narration.
- Use preset emotion when the user specifies a tone.
- Use `--timestamps-out` when the user asks for captions, subtitles, timing, or lip-sync.
- Use `cast voices clone` only when the user provides or approves a voice sample.
- Report the output path after generation.

최소 명령 세트

작업	명령어
인증 확인	`cast "test" --out typecast-test.wav`
내레이션 생성	`cast "$(cat script.txt)" --emotion smart --out narration.wav`
MP3 생성	`cast "$(cat script.txt)" --format mp3 --out narration.mp3`
자막 생성	`cast "$(cat script.txt)" --out narration.wav --timestamps-out narration.srt`
음성 선택	`cast voices pick`
음성 클로닝	`cast voices clone sample.wav --name "Project Voice"`
기본 음성 저장	`cast config set voice-id tc_xxx`

에이전트 프롬프트 예시

타입캐스트 음성 생성 스킬을 사용해줘.
script.txt에서 보이스오버 테이크 3개를 만들어줘:
- neutral
- energetic
- soft

./voiceover 아래에 저장하고 파일명을 알려줘.

기능 라우팅

에이전트가 요청에 맞는 가장 작은 CLI 기능을 고르게 하세요:

사용자 요청	에이전트가 사용할 기능
”이 문장을 말해줘”	`--out` 없이 `cast "..."`
”보이스오버 파일을 만들어줘”	`cast "$(cat script.txt)" --out narration.wav`
”자막도 같이 만들어줘”	`--timestamps-out narration.srt` 추가
”이 샘플 목소리로 해줘”	`cast voices clone sample.wav --name ...` 후 `--voice-id uc_xxx`
”몇 가지 목소리를 미리 들어보고 싶어”	`cast voices pick` 또는 `cast voices tournament`

권장 안전장치

프롬프트에 비밀키를 넣지 않기

긴 스크립트는 파일로 전달하기

긴 원고는 한 줄 명령에 직접 넣기보다 cast "$(cat script.txt)" 형태를 권장합니다.

승인된 테이크 보존하기

리뷰가 끝난 오디오를 덮어쓰지 않도록, 수정본은 새 파일명으로 만들라고 에이전트에게 지시하세요.

Claude Skills 연동

Claude Skills와 에이전트 워크플로우에서 타입캐스트를 사용하는 방법을 확인합니다.

CLI 설정

기본 음성, 모델, 출력 형식, 환경 변수를 설정합니다.

​스킬 지시문 템플릿

​최소 명령 세트

​에이전트 프롬프트 예시

​기능 라우팅

​권장 안전장치