Skill: drgeld/echodecks-ultimate (version 1.0.4)

--- name: echodecks-ultimate description: AI-powered flashcard management with automated podcast generation and spaced-repetition study tools. metadata: {"clawdbot":{"requires":{"envs":["ECHODECKS_API_KEY"]}}} --- # 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 ```

path: README.md
content: # 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."*


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)