echodecks-ultimate

# EchoDecks Skill (v1)

Integrates with EchoDecks for flashcard management, study sessions, and AI generation.

## Configuration
This skill requires the `ECHODECKS_API_KEY` environment variable to be set.

## Tools

### `echodecks_get_decks`
List all available decks or details for a specific deck.
- `id` (optional): The ID of a specific deck to retrieve.

### `echodecks_get_due_cards`
Retrieve cards that are currently due for review.
- `deck_id` (optional): Filter due cards by a specific deck ID.

### `echodecks_submit_review`
Submit a spaced repetition review for a card.
- `card_id` (required): The ID of the card being reviewed.
- `quality` (required): Integer rating (0-3).
  - 0: Again (Failure/Forgot)
  - 1: Hard
  - 2: Good
  - 3: Easy

### `echodecks_generate_cards`
Generate new flashcards from a topic or text content using AI.
- `deck_id` (required): The target deck ID for the new cards.
- `topic` (optional): A short topic string to generate from.
- `text` (optional): Raw text content to generate from.
**Note:** One of `topic` or `text` must be provided. Cost: 10 credits.

### `echodecks_generate_podcast`
Generate an audio podcast summary or conversation from a deck.
- `deck_id` (required): The source deck ID.
- `voice` (optional): Voice preference (default: "neutral").
- `type` (optional): "summary" or "conversation" (default: "summary").
**Note:** Cost: 50 credits.

### `echodecks_get_podcasts`
Retrieve existing podcasts for a deck.
- `deck_id` (optional): Filter by deck ID.
- `id` (optional): specific podcast ID.

### `echodecks_get_user_stats`
Get current user profile and study statistics.

## Implementation Details

All tools are wrappers around `skills/echodecks-v1/echodecks_client.py`.

```bash
# Example
./skills/echodecks-v1/echodecks_client.py get-due --deck-id 123
```

# Ultimate Flashcards and Podcast Tutor

**Turn your AI Agent into a Study Partner.**

This skill connects your agent to [EchoDecks](https://echodecks.app), allowing it to create flashcards, quiz you with spaced repetition, and generate audio podcasts from your study materials.

## 🚀 Why install this?
- **Study with your Agent:** "Quiz me on my Cardiology deck."
- **Generate Content:** "Create a deck about 'Machine Learning' and add 10 cards."
- **Audio Learning:** "Make a podcast conversation about this deck so I can listen while I drive."

## ✨ Features
- **Flashcard Management:** List decks, view cards.
- **Spaced Repetition:** Smart review system (Again, Hard, Good, Easy).
- **AI Generation:** Create cards from any text or topic.
- **Podcast Mode:** Convert text decks into lifelike audio discussions.
- **Stats:** Track learning progress.

## 🛠️ Configuration
Requires an `ECHODECKS_API_KEY` environment variable.
1. Get your key from [EchoDecks Settings](https://echodecks.app/settings).
2. Add it to your agent's env.

## 💡 Example Prompts
Once installed, try these with your agent:
- *"What cards are due for review today?"*
- *"Create a new deck called 'German Vocabulary'."*
- *"Generate a podcast summary for my 'History' deck."*