Agent skill
agent-generator-tutor
Interactive teaching agent for the goal-seeking agent generator and eval system. Provides a structured 14-lesson curriculum covering agent generation, SDK selection, multi-agent architecture, progressive evaluation (L1-L12), retrieval strategies, intent classification, math code generation, self-improvement loops with patch proposer and reviewer voting, and memory export/import.
Install this agent skill to your Project
npx add-skill https://github.com/rysweet/amplihack/tree/main/.claude/skills/agent-generator-tutor
SKILL.md
Agent Generator Tutor Skill
Interactive teaching agent for the goal-seeking agent generator and eval system.
What This Skill Does
Loads the GeneratorTeacher from src/amplihack/agents/teaching/generator_teacher.py
and guides users through a structured 14-lesson curriculum with exercises and quizzes.
Curriculum (14 Lessons)
| Lesson | Title | Topics |
|---|---|---|
| L01 | Introduction to Goal-Seeking Agents | Architecture, GoalSeekingAgent interface |
| L02 | Your First Agent (CLI Basics) | Prompt files, CLI invocation, pipeline |
| L03 | SDK Selection Guide | Copilot, Claude, Microsoft, Mini SDKs |
| L04 | Multi-Agent Architecture | Coordinators, sub-agents, shared memory |
| L05 | Agent Spawning | Dynamic sub-agent creation at runtime |
| L06 | Running Evaluations | Progressive test suite, SDK eval loop |
| L07 | Understanding Eval Levels L1-L12 | Core (L1-L6) and advanced (L7-L12) levels |
| L08 | Self-Improvement Loop | EVAL-ANALYZE-RESEARCH-IMPROVE-RE-EVAL-DECIDE |
| L09 | Security Domain Agents | Domain-specific agents and eval |
| L10 | Custom Eval Levels | TestLevel, TestArticle, TestQuestion |
| L11 | Retrieval Architecture | Simple, entity, concept, tiered strategies |
| L12 | Intent Classification and Math Code Gen | Nine intent types, safe arithmetic |
| L13 | Patch Proposer and Reviewer Voting | Automated code patches, 3-perspective review |
| L14 | Memory Export/Import | Snapshots, cross-session persistence |
How to Use
Start the Tutorial
from amplihack.agents.teaching.generator_teacher import GeneratorTeacher
teacher = GeneratorTeacher()
# See what lesson is next
next_lesson = teacher.get_next_lesson()
print(f"Start with: {next_lesson.title}")
Teach a Lesson
content = teacher.teach_lesson("L01")
print(content) # Full lesson with exercises and quiz questions
Check an Exercise
feedback = teacher.check_exercise("L01", "E01-01", "your answer here")
print(feedback) # PASS or NOT YET with hints
Run a Quiz
# Self-grading mode (see correct answers)
result = teacher.run_quiz("L01")
# Provide answers for grading
result = teacher.run_quiz("L01", answers=["PromptAnalyzer", "Explains stored knowledge", "False"])
print(f"Score: {result.quiz_score:.0%}, Passed: {result.passed}")
Check Progress
report = teacher.get_progress_report()
print(report) # Shows completed/locked/available lessons
Validate Curriculum Integrity
validation = teacher.validate_tutorial()
print(f"Valid: {validation['valid']}, Issues: {validation['issues']}")
Prerequisites
Each lesson has prerequisites that must be completed first. The curriculum follows a dependency graph ensuring foundational concepts are learned before advanced topics.
Exercise Validators
The teaching agent includes 15 specialized validators that check user answers for correctness. Exercises without explicit validators use a fallback that checks for key phrases from the expected output.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
rysweet/amplihack
chemist-analyst
Analyzes events through chemistry lens using molecular structure, reaction mechanisms, thermodynamics, kinetics, and analytical techniques (spectroscopy, chromatography, mass spectrometry). Provides insights on chemical processes, material properties, reaction pathways, synthesis, and analytical methods. Use when: Chemical reactions, material analysis, synthesis planning, process optimization, environmental chemistry. Evaluates: Molecular structure, reaction mechanisms, yield, selectivity, safety, environmental impact.
rysweet/amplihack
learning-path-builder
Creates personalized learning paths for technologies, frameworks, or concepts. Use for user-interactive session only for onboarding new technologies, hackathon skill-building, or personal development planning. Not for use in automated development or investigation. Sequences resources (docs, tutorials, exercises) based on current skill level and learning goals. Adapts to learning style: hands-on, theory-first, project-based.
rysweet/amplihack
gh-work-report
Generates comprehensive GitHub activity reports across all authenticated accounts. Gathers repos, PRs, features, and themes for configurable time periods (1/5/7/30/90 days). Produces shareable markdown with tables, mermaid charts, and executive summaries. Can create a private repo with GitHub Actions automation and GitHub Pages aggregation site. Use when: "github report", "work report", "activity summary", "what did I work on", "gh-work-report", "show my github activity".
rysweet/amplihack
pr-review-assistant
Philosophy-aware PR reviews checking alignment with amplihack principles. Use when reviewing PRs to ensure ruthless simplicity, modular design, and zero-BS implementation. Suggests simplifications, identifies over-engineering, verifies brick module structure. Posts detailed, constructive review comments with specific file:line references.
rysweet/amplihack
code-smell-detector
Identifies anti-patterns specific to amplihack philosophy. Use when reviewing code for quality issues or refactoring. Detects: over-abstraction, complex inheritance, large functions (>50 lines), tight coupling, missing __all__ exports. Provides specific fixes and explanations for each smell.
rysweet/amplihack
biologist-analyst
Analyzes living systems and biological phenomena through biological lens using evolution, molecular biology, ecology, and systems biology frameworks. Provides insights on mechanisms, adaptations, interactions, and life processes. Use when: Biological systems, health issues, evolutionary questions, ecological problems, biotechnology. Evaluates: Function, structure, heredity, evolution, interactions, molecular mechanisms.
Didn't find tool you were looking for?