Ultimate Flashcards / Podcasts Tutor
Scanned@drgeld
npx machina-cli add skill @drgeld/flashcards-podcasts-master --openclawEchoDecks 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.
Overview
This skill integrates with the EchoDecks External API to manage flashcards, AI-generate new cards, and synthesize audio podcasts for study sessions. It also tracks progress, credits, and study metrics, while providing direct study links and review workflows.
How This Skill Works
Connect with the EchoDecks API using the ECHODECKS_API_KEY. All features are exposed as CLI tools that wrap the echodecks_client.py script, enabling deck and card management, AI card generation, podcast creation, status checks, and direct study links. Card generation costs credits (10) and podcast creation costs credits (50), with mechanisms to submit reviews and monitor progress.
When to Use It
- Starting a new course: create a deck, then AI-generate initial cards from your sources.
- Preparing quick review: generate a concise podcast from a deck for audio study sessions.
- Managing study progress: check user stats, credits, and deck analytics before a session.
- Deepening understanding: generate targeted cards from topic text to fill knowledge gaps.
- Sharing study materials: obtain a direct study link to collaborate or study online with peers.
Quick Start
- Step 1: Set ECHODECKS_API_KEY in your environment to authenticate with the EchoDecks API.
- Step 2: Create a deck with echodecks_create_deck, providing a title and optional description.
- Step 3: Generate AI cards with echodecks_generate_cards (and optionally generate a podcast with echodecks_generate_podcast); fetch a study link with echodecks_get_study_link.
Best Practices
- Create clearly titled decks with optional descriptions and organize by course or topic.
- Provide source text to echodecks_generate_cards to improve AI-generated card quality.
- Choose podcast style wisely: summary for quick reviews, conversation for deeper dives.
- Regularly submit spaced-repetition reviews using echodecks_submit_review after recalls.
- Check credits and user stats with echodecks_get_user before large card or podcast batches.
Example Use Cases
- Create a Biology 101 deck, generate 20 AI cards, then review them with spaced repetition.
- Synthesize a 15-minute podcast from a History deck to listen during commutes.
- List cards in a deck, study a subset, and submit review quality scores to refine algorithms.
- Fetch your current credits and progress to plan your next study session.
- Get a direct study link for a deck to share with a study group.
