Echodecks Clawdbot Skill

# EchoDecks Skill

Integrates with the EchoDecks External API for flashcard management, AI generation, and audio study sessions.

## Configuration
Requires `ECHODECKS_API_KEY` environment variable.

## Tools

### `echodecks_get_user`
Get user profile, credits, and global study statistics.

### `echodecks_list_decks`
List all decks in your account.
- `id` (optional): Retrieve a specific deck by ID.

### `echodecks_create_deck`
Create a new flashcard deck.
- `title` (required): Name of the deck.
- `description` (optional): Brief description.

### `echodecks_list_cards`
List cards in a specific deck.
- `deck_id` (required): The ID of the target deck.

### `echodecks_generate_cards`
Generate new flashcards using AI.
- `deck_id` (required): The target deck ID.
- `topic` (optional): Topic string.
- `text` (optional): Detailed source text.
*Cost: 10 credits.*

### `echodecks_generate_podcast`
Synthesize an audio podcast from a deck.
- `deck_id` (required): The source deck ID.
- `style` (optional): "summary" or "conversation" (default: "summary").
*Cost: 50 credits.*

### `echodecks_podcast_status`
Check the progress of a generated podcast.
- `id` (required): The podcast ID.

### `echodecks_get_study_link`
Get a direct link to a web-based study session.
- `deck_id` (required): The deck to study.

### `echodecks_submit_review`
Submit a spaced-repetition review for a card.
- `card_id` (required): The ID of the card.
- `quality` (required): 0 (Again), 1 (Hard), 2 (Good), 3 (Easy).

## Implementation
All tools wrap the `scripts/echodecks_client.py` CLI.

# EchoDecks ⚡️

**EchoDecks** is the ultimate AI-powered, audio-first active recall system. Transform your knowledge into intelligent flashcards and listen to them as personalized podcasts. Built for high-stakes learning (Cardiology, Software Engineering, Health Informatics), EchoDecks turns dead time into study time.

This skill integrates **Clawdbot** directly with the EchoDecks ecosystem, allowing for seamless deck management, AI card generation, and podcast synthesis via the EchoDecks External API.

## 🚀 Features

- **Instant AI Card Generation**: Feed it a topic or a wall of text; get structured flashcards in seconds.
- **Audio-First Spaced Repetition**: Review your cards via CLI or get direct links to the EchoDecks Web App.
- **Podcast Synthesis**: Generate high-quality audio summaries or conversations from your decks to listen on the go.
- **Real-Time Stats**: Track your learning streaks, accuracy, and credit balance.
- **Spaced Repetition (SM-2)**: Submit reviews directly from the chat to update your card intervals.

## 🛠 Installation

1.  **Get your API Key**: Go to [EchoDecks Developer Settings](https://echodecks.app/settings/developer) and generate an API key.
2.  **Set Environment Variable**:
    ```bash
    export ECHODECKS_API_KEY='sk_echo_your_key_here'
    ```
3.  **Install Skill**:
    ```bash
    clawdhub install echodecks
    ```

## 📖 API Usage Summary

- **Resource: Decks** (List, Create, Detail)
- **Resource: Cards** (List cards per deck)
- **Resource: Generate** (AI Flashcard creation)
- **Resource: Podcasts** (Generate and poll status)
- **Resource: Study** (Submit reviews, start sessions, get links)

---
*Built with ❤️ by Mohammed Abualsoud & Cipher.*
[echodecks.com](https://echodecks.com) | [moltbook.md](https://molt.bot)