---

🎓 edu-agent-skills

Turn your standard, code-dumping AI coding agents into elite technical mentors, adaptive teachers, and debugging coaches.

Most AI coding assistants are built to do the work for you. They dump solutions, fix bugs silently, and reinforce passive copying. edu-agent-skills changes that.

This repository provides 20 standardized, plug-and-play educational skill specifications that inject rigorous, active-learning pedagogy directly into your favorite coding agents (Gemini CLI, Claude Code, Cursor, and more) with a single command.

---

🎯 Who is this for?

Whether you are a developer looking to upskill, an educator scaling personalized instruction, or an agent builder, edu-agent-skills is designed to fit your workflow:

User Profile	How It Helps You
🧑‍💻 Learners & Self-Taught Devs	Prevent AI "codewriting dependency." Instead of having the AI copy-paste code, learn system architectures, debug workflows, and build core comprehension with an AI tutor that explains, quizzes, and guides you.
🎓 Educators & Bootcamps	Scale high-quality active pedagogy. Standardize how AI learning companions orient students, diagnose prerequisite gaps, evaluate understanding, and coach project implementation inside your course repositories.
🛠️ AI Agent & Tool Builders	Embed state-of-the-art teaching behaviors out of the box. Integrate modular, vendor-neutral skill profiles that work seamlessly in Gemini CLI, Claude Code, Cursor, and custom agent runtimes without hardcoding orchestration logic.

---

🚀 Quick Start

Inject all 20 skills into your detected agent runtimes with just one command:

# Auto-detect your local agents and install all skills
npx edu-agent-skills install

Or target a specific agent:

# Target Gemini CLI
npx edu-agent-skills install --agent gemini

# Target Claude Code
npx edu-agent-skills install --agent claude

How it works: Under the hood, the CLI detects your installed tools and places the standardized skill specifications where the agents can automatically load and activate them. The skills activate dynamically when your agent encounters relevant learning contexts!

---

🛠️ CLI Usage

Take complete control over your educational environment using the built-in CLI:

# List all available skills and categories
npx edu-agent-skills list

# Show detailed documentation, metadata, and status of a specific skill
npx edu-agent-skills info teach-concept

# Detect compatible agents installed on your local machine
npx edu-agent-skills detect

# Install only specific selected skills
npx edu-agent-skills install --skills teach-concept,debug-teacher

# Install into current project directory scope instead of globally
npx edu-agent-skills install --scope project

# Target a completely custom folder directory
npx edu-agent-skills install --target ./my-agent/skills

# Uninstall skills from a target agent
npx edu-agent-skills remove --agent gemini

---

📚 Available Skills (20)

The repository organizes educational competencies into 6 cognitive categories that compose together to guide learners from first-contact onboarding to production-grade project delivery.