algernon-feynman
Feynman Technique study session for OpenAlgernon. Use when the user runs `/algernon feynman [SLUG]`, says "feynman", "quero explicar conceitos", "me testa explicando", "tecnica feynman", "ensinar para aprender", or "quero consolidar [material]". The goal is to expose gaps in understanding by making the user teach concepts back in their own words.
Best use case
algernon-feynman is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Feynman Technique study session for OpenAlgernon. Use when the user runs `/algernon feynman [SLUG]`, says "feynman", "quero explicar conceitos", "me testa explicando", "tecnica feynman", "ensinar para aprender", or "quero consolidar [material]". The goal is to expose gaps in understanding by making the user teach concepts back in their own words.
Teams using algernon-feynman should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/algernon-feynman/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How algernon-feynman Compares
| Feature / Agent | algernon-feynman | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Feynman Technique study session for OpenAlgernon. Use when the user runs `/algernon feynman [SLUG]`, says "feynman", "quero explicar conceitos", "me testa explicando", "tecnica feynman", "ensinar para aprender", or "quero consolidar [material]". The goal is to expose gaps in understanding by making the user teach concepts back in their own words.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
SKILL.md Source
# algernon-feynman
You run a Feynman Technique session: the user explains concepts aloud, you
identify gaps without giving away the answer, and you use Socratic questions to
push them to fill those gaps themselves. Only reveal the reference answer after
two attempts.
## Constants
```bash
ALGERNON_HOME="${ALGERNON_HOME:-$HOME/.openalgernon}"
DB="${ALGERNON_HOME}/data/study.db"
NOTION_CLI="${NOTION_CLI:-notion-cli}"
```
## Step 1 — Select Concepts
Query cards for the material, preferring N2 and N3 level cards (they have richer
reference content). Select 3-5 concepts for this session.
```bash
sqlite3 "$DB" \
"SELECT c.id, c.front, c.back, c.tags
FROM cards c
JOIN decks d ON d.id = c.deck_id
JOIN materials m ON m.id = d.material_id
WHERE m.slug = 'SLUG'
ORDER BY
CASE WHEN c.tags LIKE '%N3%' THEN 1
WHEN c.tags LIKE '%N2%' THEN 2
ELSE 3 END,
RANDOM()
LIMIT 5;"
```
If no cards found: "No cards found for 'SLUG'. Run `texto SLUG` first to generate cards."
## Step 2 — For Each Concept
### Present
AskUserQuestion (free text):
> "Explain [CONCEPT] as if you were teaching someone with no background in this area. Take your time."
### Evaluate Across Three Dimensions
After the user answers, evaluate internally (do not share the scoring rubric):
1. **Accuracy** — Is the core claim correct? Does it match the reference answer?
2. **Depth** — Does the explanation go beyond restating the definition? Does it cover the "why"?
3. **Transfer** — Does the user use an original analogy, metaphor, or real-world example?
### If All Three Dimensions Pass
Respond: "Solid explanation. [1-sentence observation about what was particularly strong.]"
Advance to the next concept.
### If Any Dimension Fails
Do not reveal the reference answer yet. Ask one Socratic follow-up targeting the
weakest dimension:
- Failed accuracy: "You said [claim]. What happens in the case where [counterexample]?"
- Failed depth: "What would break if you removed [key component] from your explanation?"
- Failed transfer: "Can you give me a concrete example of where you'd see this in a real system?"
Allow one more attempt. After the second attempt:
- If passing — acknowledge and proceed.
- If still failing — reveal the reference answer and name the gap explicitly:
"The missing piece was: [specific concept from the reference answer]."
## Step 3 — Session Summary
```
Feynman session complete -- MATERIAL_NAME
Concepts: N
All three dimensions passed: X/N
Partial passes (needed one probe): Y/N
Needs more work: [list of concepts that required two attempts or failed]
```
### Save to Notion (optional)
If `$NOTION_CLI` is available and `$NOTION_PAGE_ID` is set:
```bash
"$NOTION_CLI" append --page-id "$NOTION_PAGE_ID" --content "MARKDOWN"
```
Include: session date, per-concept result (pass/partial/fail), weak points identified,
suggested review focus.
### Save Memory
```bash
echo "[HH:MM] feynman session -- MATERIAL_NAME | Concepts: N | Passed: X | Needs work: LIST" \
>> "${ALGERNON_HOME}/memory/conversations/YYYY-MM-DD.md"
```Related Skills
feynman-technique-explainer
Explain any concept using the Feynman Technique, plain language, a real-world analogy, a concrete example, and a comprehension quiz. No jargon from the concept allowed.
algernon-texto
Block-by-block reading mode for OpenAlgernon materials. Use when the user runs `/algernon texto SLUG`, `/algernon paper SLUG`, says "quero ler [material]", "vamos ler [topic] bloco a bloco", "modo texto", or "leitura guiada". Also activates when the user is mid-session and selects /continue between blocks. Paper mode adds structured reflection between major sections.
algernon-synthesis
Cross-material knowledge synthesis session for OpenAlgernon. Use when the user runs `/algernon synthesis`, says "quero conectar os materiais", "sintese entre materiais", "como X se relaciona com Y", "visao geral do curriculo", "integrar o conhecimento", or "ver o quadro geral". Requires at least 2 materials with reviewed cards. Surfaces conceptual bridges across materials and ends with a production scenario challenge.
algernon-sprint
Timed interleaved study sprint for OpenAlgernon. Use when the user runs `/algernon sprint [15|25|45]`, says "sprint de estudo", "sessao cronometrada", "25 minutos de revisao", "modo pomodoro", "quero fazer um sprint", or "revisar varios materiais de uma vez". Cards from all installed materials are shuffled and interleaved. Ends with a post-sprint retrieval test to measure retention gain.
algernon-review
FSRS-4.5 flashcard review session for OpenAlgernon. Use when the user runs `/algernon review`, says "revisar flashcards", "quero revisar", "cards em atraso", "modo revisao", "review session", or asks to practice due cards. Handles all card types (flashcard, dissertative, argumentative), AI evaluation of open-ended answers, automatic FSRS scheduling, N1/N2/N3 promotion, and correction card generation.
algernon-orchestrator
Main orchestrator for the OpenAlgernon personal study system. Use this skill at the start of every study session, or whenever the user runs /algernon, says "quero estudar", "iniciar sessao", "abrir algernon", or asks what materials are available. Also handles the /algernon help command and routes any unmatched command to the right sub-skill.
algernon-interview
Mock technical interview mode for OpenAlgernon. Use when the user runs `/algernon interview [SLUG]`, says "me entrevista sobre [material]", "simula entrevista tecnica", "mock interview", "entrevista de emprego", "quero praticar entrevista", or "me faz perguntas tecnicas". Simulates a senior AI engineering interviewer with adaptive difficulty, follow-up probes, and a full scored report at the end.
algernon-debate
Design trade-off debate mode for OpenAlgernon. Use when the user runs `/algernon debate [SLUG]`, says "quero debater [topic]", "me desafia sobre trade-offs", "debate tecnico", "discutir decisoes de design", "quando usar X vs Y", or "argumento tecnico". Forces the user to defend a position and exposes nuances they may not have considered. Ends with a synthesis that is exactly what you would say in a technical interview.
---
name: article-factory-wechat
humanizer
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
tavily-search
Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.