Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/smileynet/teach-me/agents-mdgit clone --depth 1 https://github.com/smileynet/teach-meWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/smileynet/teach-me/agents-md)<a href="https://agentmods.dev/instructions/smileynet/teach-me/agents-md"><img src="https://agentmods.dev/badge/instructions/smileynet/teach-me/agents-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.03757 | $0.03757 |
| Opus 5 | $0.01878 | $0.01878 |
| Sonnet 5 | $0.00751 | $0.00751 |
| Haiku 4.5 | $0.00376 | $0.00376 |
Grade B, and why
teach-me AGENTS.md scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Sends data to an external URLmediumData exfiltration
A POST to an outside endpoint may be telemetry or may be exfiltration; either way the mod talks to somewhere, and you should know where.
- PowerShell mangles complex inline shell-arg strings — inline JSON (`curl -d '{...}'`), `->`, backslashes, and long `git commit -m`/`tkt close --resolution` bodies get corrupted or misparsed. Use a file instead: `--data Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
| Validating work | Validate from the user's perspective (Playwright click-through, curl the endpoint, load the page). Prefer linters, syntax checkers, and templates over formal test suites. Only write maintained tests f How it starts
The opening of the file, as written. The whole thing — 149 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md — teach-me
Test bed for learning-oriented agent skills. Refined here, then ported to crew-research for global deployment.
Workspace Layout
workspace/ — THE user's live learning workspace (gitignored, auto-created on first serve)
.kiro/skills/ — agent skills (teach, quiz-me, wait-what, jargon, visual-qa, theme, etc.)
.kiro/steering/ — visual-teaching guidelines
.memory/ — persistent knowledge (CONTEXT.md glossary, ADRs, research findings)
.scratch/ — ephemeral (gitignored) — only visual-qa output regenerated on run
.references/ — cloned reference repos (gitignored, rehydrate via mise run rehydrate)
tools/ — project scripts (draw-diagram, visual-qa, theme-preview, render-diagrams, sr-*)
tools/lib/ — Python helpers (preact_page.py for generating Preact HTML shells)
palettes/ — color palette definitions (JSON)
assets/ — shared: style.css, CSS variables, SVG patterns
assets/vendor/ — vendored Preact + Signals + HTM + dagre (self-hosted, no CDN)
assets/components/ — Preact components (MapView, TopicCard, QuizView, etc.)
assets/services/ — signal services (generation.js SSE stream)
assets/scaffolds/ — content-pattern examples (boilerplate is in tools/lib/page_template.py)
.tickets/ — local ticket tracking
library/ — public topic library (shipped, growing; served by default on a fresh clone — ADR 0012). Committed lessons/maps/reference per domain.
workspace/ is the single live workspace per machine — all topics (maps, lessons, quizzes, reference docs, learning records) go here. Gitignored (user-local); auto-created on first mise run serve. Lessons are organized by domain: lessons/{domain-slug}/NN-slug.html, per-domain numbering from 01; quizzes and maps parallel this (lessons/{domain-slug}/quiz/, lessons/{domain-slug}/{domain}-map.html).
Skills
| Skill | Trigger | What it does |
|---|---|---|
| teach | /teach, "teach me", "next lesson" |
Multi-session learning with stateful workspace |
| generate-topic | /generate-topic, "generate lesson", "complete topic" |
Full pipeline: research → lesson → post-process → verify (parallel subagents) |
| quiz-me | /quiz-me, "test me" |
Socratic dialog — learner explains, agent probes |
| wait-what | /wait-what, "I don't understand" |
Re-explain when comprehension fails |
| jargon | /jargon, "annotate terms" |
Post-authoring: annotate domain jargon with tooltips |
| visual-qa | "visual qa", "check the ui" | Exercise components, capture screenshots, report |
| theme | "theme", "colors", "palette" | Preview, validate, and apply color palettes |
| draw-diagram | "draw diagram", "generate SVG" | Generate inline SVG teaching diagrams |
| browse-and-verify | "validate link", "check this URL" | Dispatch browser agent for URL validation |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- today Changed · -4 lines · -42 tokens per session 5e23ae7620e9
- 4d ago First seen · 153 lines · 3,799 tokens per session scan B 5ee19fb4749d
teach-me AGENTS.md is an instructions file published in the GitHub repository smileynet/teach-me (3 stars, last pushed today), licensed MIT. It adds 3,757 tokens to every session, about $0.0188 per session on Opus 5. A static security scan graded it B with 2 findings (sends data to an external url, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
learn-faster-kit AGENTS.md
AGENTS.md instructions for hluaguo/learn-faster-kit, covering repository guidelines, project structure & module organization, build, test, and development commands, coding style & naming conventions and testing guidelines.
p5.js AGENTS.md
AGENTS.md instructions for processing/p5.js, covering detailed guidelines for ai coding assistants and agents, generating any analysis of the codebase, stop signs for agents, character and tone and who you are in this conversation.
claude-tutor CLAUDE.md
Claude Code instructions for kirilxd/claude-tutor, covering claude.md, what this is, testing, architecture and data layout.
rolecraft AGENTS.md
Instructions for Sri-Ln/rolecraft, covering rolecraft — ai agent instructions, what rolecraft is, voice and tone, sources of truth and data contract (critical).
ai-learning-assistant AGENTS.md
Instructions for mhghotbi/ai-learning-assistant, covering agent operating contract, read order, non-negotiable rules, learning depth scale and learning modes.
ai-learning-assistant CLAUDE.md
Instructions for mhghotbi/ai-learning-assistant: Follow AGENTS.md as the repository-wide authority.