EduAgentsKit

Getting started

Here’s how to set up the skills in your AI tool and try your first lesson. Take it one step at a time. If you get stuck, help is at the bottom of the page.

Where things stand

EduAgentsKit is new (version 0.1.0 in the repository). The skills follow the open Agent Skills format, and the repository documents where each AI tool looks for skills, checked against each tool’s own documentation on 13 October 2026. The skills have not yet been tested live in any of these tools. Expect rough edges. If you try one, please tell us what happened, good or bad. That’s the most useful help you can give right now.

What you’ll need

  • Your own AI tool that can load skills from a folder. The repository documents setup for: Claude Code, Codex (CLI, IDE extension, or ChatGPT desktop app), Cursor, Grok (Grok Build CLI), and OpenCode.
  • A Windows, Mac, or Linux computer where you can install that tool. (If it’s a school computer, ask your IT team first.)
  • Git, the free tool the commands below use to download the kit. [TBD: link to a teacher-friendly Git install guide, or a no-Git download route (Q-START-6)]
  • A little time, and a willingness to copy and paste a few commands. [TBD: add a setup time only once it has been measured (Q-START-4)]

You don’t need Node.js, any other software, or a GitHub account to use the skills.

About cost

EduAgentsKit is free (MIT License). Your AI tool is not part of the kit: you choose it, sign up for it, and pay for whatever plan it requires. Check that tool’s pricing before you start. If your school provides one of these tools, you may not need to buy anything.

What’s a terminal?

A terminal is a window where you type commands. On a Mac it’s the app called Terminal. On Windows, use PowerShell. Some AI tools, such as Cursor, also have one built in. You copy a command from this page, paste it in, and press Enter.

Just for you, or for a whole project?

Personal

The skills load everywhere on your computer. Best if you plan lessons in many folders.

Project

The skills load only inside one folder, and anyone who copies that folder gets them too. Useful for a shared department planning folder.

The steps below use personal scope. Project folders are in the table in step 2.

Set up EduAgentsKit

  1. Download the kit.

    Open a terminal and paste:

    git clone https://github.com/EduAgentsKit/edu-agents.git

    Copy this, paste it into your terminal, and press Enter.

    This makes a folder called edu-agents with everything inside.

  2. Find your tool’s skills folder.

    Documented setup: checked against each tool’s documentation on 13 Oct 2026, not yet tested live. Tools change, so follow the link if a path stops working.

    Where each AI tool looks for skills (documented, not tested live)
    Your AI toolPersonal folderProject folderTool’s documentation
    Claude Code~/.claude/skills/.claude/skills/Extend Claude with skills
    Codex (CLI, IDE extension, ChatGPT desktop app)~/.agents/skills/.agents/skills/Build skills
    Cursor~/.cursor/skills/ or ~/.agents/skills/.cursor/skills/ or .agents/skills/Agent Skills
    Grok (Grok Build CLI)~/.grok/skills/ or ~/.agents/skills/.grok/skills/Skills, Plugins and Marketplaces
    OpenCode~/.config/opencode/skills/ or ~/.agents/skills/.opencode/skills/ or .agents/skills/Agent Skills

    Tip: one folder for most tools. Codex, Cursor, Grok, and OpenCode all document ~/.agents/skills/ as a personal folder. Copy the skills there once, and those four tools can find them. Claude Code doesn’t list that folder, so if you use Claude Code, also copy to ~/.claude/skills/.

  3. Copy the skills.

    Choose your computer:

    Mac or Linux

    mkdir -p ~/.agents/skills
cp -R edu-agents/skills/* ~/.agents/skills/

    Windows PowerShell

    New-Item -ItemType Directory -Force "$HOME\.agents\skills"
Copy-Item -Recurse edu-agents\skills\* "$HOME\.agents\skills\"

    Claude Code (Mac or Linux)

    mkdir -p ~/.claude/skills
cp -R edu-agents/skills/* ~/.claude/skills/

    Copy this, paste it into your terminal, and press Enter.

    Using a different folder from the table? Replace ~/.agents/skills with it.

    Don’t worry about overwriting: every skill name starts with edu-, so copying won’t replace skills you already have. Only an older copy of EduAgentsKit gets replaced, which is what you want when you update.

  4. Check that it’s working.

    Start a new session in your AI tool and ask:

    Which skills do you have for lesson planning?

    It should list the EduAgentsKit skills. In Claude Code and Grok, you can also type /skills. In Codex, type /skills or $.

    If a skill is missing: make sure each skill’s folder sits directly in the skills folder, with SKILL.md inside it.

    Correct: ~/.agents/skills/edu-lesson-planner/SKILL.md

    Not: ~/.agents/skills/skills/edu-lesson-planner/SKILL.md

    Then restart the tool.

Optional extras

Install the agents (optional)
  • Claude Code: copy the files from agents/ to ~/.claude/agents/ (or a project’s .claude/agents/). The project notes it hasn’t tested whether Claude Code preloads the listed skills, but each agent names its skills in its text too.
  • Grok: xAI’s documentation says Grok reads Claude Code agents, so the same folders apply. Not tested.
  • Other tools: paste the agent file’s text into your first message, or into the project’s AGENTS.md file, and ask the AI to follow it.
Using a chat assistant without a skills folder? (not verified)

The project found no public documentation of a skills folder for chat assistants. Instead, attach or paste the SKILL.md you need into the conversation and ask the assistant to follow it.

Keep it up to date

In your terminal, go into the edu-agents folder, run git pull, then copy the skills again (step 3).

For the tech-savvy: link instead of copy

A symbolic link keeps skills current after git pull. Claude Code and Codex document that they follow linked skill folders; for other tools, copy instead. Full commands: Install guide on GitHub .

Try it: your first lesson draft

  1. Open your AI tool and ask (this request is the one from the project’s quick start):

    Write a 45-minute Grade 3 lesson on unit fractions, with an exit ticket. Standard: CCSS 3.NF.A.1.

  2. The skills are designed so the AI picks the matching ones (here, Lesson planner and Formative checks), asks for anything missing, and drafts the lesson.
  3. Compare it with the Grade 3 worked example to see what the skills aim for.
  4. Ask for one change, like “add a hands-on activity.”
  5. Review it with the checklist on the responsible-use page before you use it.

Tip: Describe your class in general terms (“two students are newcomer English learners”) rather than naming or describing individual students.

Stuck? Here’s where to go

Browse the catalog