algernon-review

What This Skill Does

The algernon-review skill is a sophisticated spaced repetition engine designed for OpenAlgernon, leveraging the advanced FSRS-4.5 (Free Spaced Repetition Scheduler) algorithm. It transforms your CLI-based workflow into a rigorous, data-driven learning environment. Unlike simple flashcard apps, this skill manages a complex state machine that tracks card stability, difficulty, and lapse history, ensuring that your study time is optimized for maximum long-term retention. It dynamically selects up to 50 due cards from your study.db based on your current progress.

The skill is uniquely capable of handling three distinct knowledge formats: standard flashcards, dissertative questions (requiring detailed conceptual recall), and argumentative cards (requiring structural analysis). For open-ended questions, the skill employs AI evaluation to grade your responses, offering critical feedback, identifying logical gaps, and flagging misconceptions. When a misconception is detected, the skill automatically generates a correction card, ensuring that you don't reinforce incorrect mental models.

Installation

To add this skill to your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/antoniovfranco/algernon-review

Ensure that your environment variables, specifically ALGERNON_HOME, are correctly configured so the skill can locate your study.db file.

Use Cases

• Long-term Knowledge Retention: Perfect for students or professionals memorizing complex technical definitions, legal statutes, or language vocabulary.
• Self-Correction & Mastery: Ideal for those engaging in 'active recall' where AI-driven feedback provides a layer of accountability that static flashcards cannot match.
• Structured Learning: Useful for users preparing for certifications or examinations who need to balance fact-based memorization with argumentative synthesis.

Example Prompts

1. "/algernon review"
2. "Quero revisar meus cards em atraso agora, por favor."
3. "Start a new review session for my due cards."

Tips & Limitations

• Data Integrity: Always ensure your study.db is backed up, as this skill performs direct write operations to the database.
• AI Evaluation: While AI evaluation is robust, remember that for highly technical or nuanced subjects, your self-assessment of the 'Good' vs 'Again' grade remains the final authority.
• Focus: If you have thousands of overdue cards, the skill limits the session to 50 cards per run to prevent cognitive overload. Perform multiple sessions if necessary.
• Connectivity: This skill requires an active internet connection to access the AI evaluation engine for dissertative and argumentative responses.