# agent_skills (janestreet/agent_skills)

> A collection of agent skills from Jane Street. Each skill is a folder with a SKILL.md file of instructions that turns an AI agent or chatbot into a specialized helper. Right now it ships one skill, socratic-tutor.

- GitHub: https://github.com/janestreet/agent_skills
- GitHub.Locker page: https://github.locker/janestreet/agent_skills
- Stars: 9.9K
- License: MIT
- Last push: 2026-11-17

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is this a library or an app I install?**

Neither. There is no code to install, only Markdown instruction files. You copy a skill folder into your agent's skills directory, or paste the SKILL.md text into a chat.

**How do I start using a skill?**

With a coding agent that supports the SKILL.md format, copy the skill folder into its skills directory and ask it to use the skill. In a plain chatbot, paste the SKILL.md body into the chat or a system prompt, then add what you want it to do.

**Which agents does it work with?**

Any coding agent that supports the common SKILL.md format, and any plain chatbot through copy-paste. The README does not name specific agents.

**How big is the catalog?**

Only one skill is listed at the moment, so this is a small starter collection rather than a broad library.

**How does the tutor decide what to ask next?**

It starts with a diagnostic, builds a skill map with levels 0-5, asks one question at a time, schedules spaced review, and ends with a final assessment.

**How do I make my own skill?**

Create a directory with a SKILL.md file containing instructions for the agent, using the same layout as socratic-tutor.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/janestreet/agent_skills/blob/master/README.md

# Agent skills from Jane Street

A collection of skills for AI agents and chatbots.
Each skill is a directory containing a `SKILL.md` file
with instructions for the agent.

## Skills

- **socratic-tutor** — turns an LLM into a strict personal tutor that teaches a
  topic of your choice using the Socratic method: a diagnostic, a skill map with
  levels 0-5, one question at a time, spaced review, and a final assessment.

## How to use

With a coding agent that supports the common `SKILL.md` format, copy the skill
directory into your agent's skills folder, then ask the agent to use it
("teach me X").

With a plain chatbot, paste the body of the skill's `SKILL.md` into the chat
(or into a custom/system prompt), followed by what you want it to do.

## Contributing

These skills are exported from our internal repository, where we use them day to
day, and we hope it's interesting to share that experience more widely. Since
we're trying to share what _we've_ found to be useful, we're not looking for new
skills or for pull requests that change the text of existing ones. If you've
adapted a skill and it works better for you, that's great, but please keep your
own copy.

Issues are welcome if something doesn't work as described, though we may not be
able to act on all of them.

## Prior art

Teaching by asking questions is the
[Socratic method](https://en.wikipedia.org/wiki/Socratic_method), which is
rather older than LLMs, and there are other tutoring prompts and skills built on
the same idea. Our skill was written internally and isn't knowingly derived from
any other implementation.

