> ## Documentation Index
> Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트 스킬 연결

> AI 에이전트 스킬에서 CLI를 호출해 타입캐스트 음성을 생성하는 방법입니다.

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

## 스킬 지시문 템플릿

```markdown theme={null}
# 타입캐스트 음성 생성 스킬

사용자가 보이스오버, 내레이션, 대사, 오디오 미리듣기를 요청하면 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`                                             |

## 에이전트 프롬프트 예시

```text theme={null}
타입캐스트 음성 생성 스킬을 사용해줘.
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`                  |

## 권장 안전장치

<AccordionGroup>
  <Accordion title="프롬프트에 비밀키를 넣지 않기">
    API 키는 `cast login` 또는 `TYPECAST_API_KEY`로 보관하세요. 공유 프롬프트나 생성 문서에 키를 붙여넣지 마세요.
  </Accordion>

  <Accordion title="긴 스크립트는 파일로 전달하기">
    긴 원고는 한 줄 명령에 직접 넣기보다 `cast "$(cat script.txt)"` 형태를 권장합니다.
  </Accordion>

  <Accordion title="승인된 테이크 보존하기">
    리뷰가 끝난 오디오를 덮어쓰지 않도록, 수정본은 새 파일명으로 만들라고 에이전트에게 지시하세요.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Claude Skills 연동" icon="wand-magic-sparkles" href="/ko/integrations/claude-skills">
    Claude Skills와 에이전트 워크플로우에서 타입캐스트를 사용하는 방법을 확인합니다.
  </Card>

  <Card title="CLI 설정" icon="gear" href="/ko/cli-reference/configuration">
    기본 음성, 모델, 출력 형식, 환경 변수를 설정합니다.
  </Card>
</CardGroup>