> ## 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.

# Skills

<Info>
  [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) is Anthropic's AI coding assistant. With **Typecast Skills**, Claude can help you integrate TTS into your projects - just ask in natural language!
</Info>

## What You Can Do

With Typecast Skills for Claude, you can:

- **Get step-by-step guidance** for API integration in Python, JavaScript, or cURL
- **Generate working code** tailored to your use case
- **Troubleshoot errors** with detailed explanations and solutions
- **Compare pricing plans** and calculate costs
- **Discover voices** that match your project needs

---

## Prerequisites

Before you start, make sure you have:

1. **Claude Code** - Install from [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) (official installation guide)
2. **Typecast API Key** - [Get yours here](https://studio.typecast.ai/developers/api/)

---

## Installation

Open Claude Code and run the following command:

```bash
npx skills add neosapience/typecast-skills
```

That's it! You're ready to use Typecast Skills.

### Verify Installation

Ask Claude: **"What can you help me with for Typecast API?"**

If installed correctly, Claude will introduce itself as the Typecast TTS API expert agent.

<Tip>
  **Manual Installation**: You can also copy the skill folder directly to:
  - Personal scope: `~/.claude/skills/`
  - Project scope: `.cursor/skills/`
</Tip>

---

## Quick Start: Your First Voice Generation

Just ask Claude in natural language! Here are some example prompts:

### Basic Setup

<CodeGroup>
```text Get Started
How do I get started with Typecast TTS API?
```

```text API Key
How do I get a Typecast API key?
```

```text Voice List
Show me how to list available voices in Python.
```
</CodeGroup>

### Generate Code

<CodeGroup>
```text Python
Write Python code to convert "Hello world" to speech using Typecast API.
```

```text JavaScript
Create a JavaScript function for text-to-speech with happy emotion.
```

```text cURL
Give me a cURL command to generate speech with the ssfm-v30 model.
```
</CodeGroup>

### Troubleshoot Errors

<CodeGroup>
```text 403 Error
I'm getting a 403 error with Typecast API. What should I check?
```

```text Rate Limit
I got error 429 - too many requests. What are the rate limits?
```

```text Voice Not Found
My voice_id returns 404. How do I find valid voice IDs?
```
</CodeGroup>

---

## Example Conversations

### Getting Started (No Coding Experience)

<AccordionGroup>
  <Accordion title="User: I want to add voice to my app but I've never used an API before.">
    **Claude will:**
    1. Explain what an API is in simple terms
    2. Guide you through getting an API key
    3. Show the simplest possible code example
    4. Explain each line of code
  </Accordion>
  <Accordion title="User: What's the difference between ssfm-v21 and ssfm-v30?">
    **Claude will:**
    - Explain that v30 is the latest model with better quality
    - List the available emotions for each model
    - Recommend v30 for new projects
    - Explain Smart Mode (context-aware emotion)
  </Accordion>
</AccordionGroup>

### Integrating with Your Project

<AccordionGroup>
  <Accordion title="User: I'm building a React app and need TTS. Help me integrate Typecast.">
    **Claude will:**
    1. Explain that API calls should go through a backend (security)
    2. Provide a Node.js/Express backend example
    3. Show how to call it from React
    4. Include error handling
  </Accordion>
  <Accordion title="User: Add Typecast TTS to my FastAPI server.">
    **Claude will:**
    1. Generate a complete FastAPI endpoint
    2. Use environment variables for the API key
    3. Include proper error handling
    4. Show example request/response
  </Accordion>
</AccordionGroup>

---

## What Claude Knows About Typecast

| Topic | What Claude Can Help With |
|-------|---------------------------|
| **API Basics** | Authentication, endpoints, request/response format |
| **Code Samples** | Python SDK, JavaScript SDK, Direct API, cURL |
| **Voice Selection** | 600+ voices, filtering by gender/age/use case |
| **Emotion Control** | Preset emotions, Smart Mode, intensity adjustment |
| **Audio Settings** | Format (WAV/MP3), volume, pitch, tempo |
| **Error Handling** | All error codes (400-500) with solutions |
| **Pricing** | Plan comparison, credit calculation |
| **Best Practices** | Security, environment variables, rate limits |

---

## Tips for Best Results

<CardGroup cols={2}>
  <Card title="Be Specific" icon="crosshairs">
    Instead of "help with TTS", try "generate Python code for sad emotion with ssfm-v30"
  </Card>
  <Card title="Mention Your Stack" icon="layer-group">
    Tell Claude your tech stack: "I'm using Next.js with TypeScript"
  </Card>
  <Card title="Share Errors" icon="bug">
    Paste the full error message - Claude will diagnose and fix it
  </Card>
  <Card title="Ask Follow-ups" icon="comments">
    Claude remembers context, so ask "now add error handling" or "convert to TypeScript"
  </Card>
</CardGroup>

---

## Keeping Up to Date

Update Typecast Skills to get the latest features and fixes:

```bash
npx skills update
```

---

## Troubleshooting

<AccordionGroup>
  <Accordion title="Claude doesn't recognize Typecast commands">
    - Verify the skill is properly installed in your settings
    - Try restarting Claude Code
    - Check that the skills repository is accessible
  </Accordion>
  <Accordion title="Claude gives outdated information">
    - Ask Claude to check the latest documentation
    - Mention you want "ssfm-v30" specifically for the latest features
    - Update your local skills repository if cloned locally
  </Accordion>
  <Accordion title="Code examples don't work">
    - Make sure you've replaced `YOUR_API_KEY` with your actual key
    - Check that you're using a valid `voice_id`
    - Verify your API plan supports the model you're using
  </Accordion>
</AccordionGroup>

---

## Resources

<CardGroup cols={2}>
  <Card
    title="Get API Key"
    icon="key"
    href="https://studio.typecast.ai/developers/api/"
  >
    Get your Typecast API key
  </Card>
  <Card
    title="Voice Library"
    icon="microphone"
    href="https://studio.typecast.ai/developers/api/voices"
  >
    Browse all available voices
  </Card>
  <Card
    title="API Reference"
    icon="code"
    href="/api-reference"
  >
    Explore the Typecast API
  </Card>
  <Card
    title="Skills Repository"
    icon="github"
    href="https://github.com/neosapience/typecast-skills"
  >
    View source on GitHub
  </Card>
</CardGroup>