journal — скилл для Claude Code: заметки о том
Скилл записывает короткие заметки о том, что понял или не понял во время учёбы, и складывает их в progress/journal.md. Пригодится, если хотите вести дневник обучения без лишних движений.
npx skills add TakaGoto/rag-learning-academy --skill journal -a claude-codeЧто делает journal
Скилл берёт текст, который вы передаёте вместе с вызовом, и относит его к одной из пяти категорий: insight, confusion, question, idea или note. Если текст не передан, скилл спросит, что на уме. Запись дописывается в конец progress/journal.md, файл создаётся, если его ещё нет. Формат простой: заголовок с датой и категорией, ниже ваши слова.
Ваш текст скилл не переписывает и не причёсывает. Это дневник для вас, а не для системы, поэтому ответ после записи короткий: подтверждение для заметки, подбадривание для идеи, предложение разобрать тему через /explain, если речь о непонятном. Превращать это в урок скилл не станет, пока вы сами не попросите.
Небольшая оговорка: заметки ложатся в progress/journal.md относительно текущего каталога, так что запускать скилл стоит из корня проекта. Все слэш-команды, на которые ссылается скилл (/explain, /lesson, /roadmap, /sandbox), живут в том же наборе rag-learning-academy, без него подсказки будут вести в пустоту.
Какие задачи решает
- записать мысль, которая только что сложилась в голове
- сохранить вопрос на потом, чтобы не потерять
- отметить место, где окончательно запутался
- зафиксировать идею проекта для будущих экспериментов
- собрать историю учёбы в одном файле
Примеры запросов агенту
- /journal наконец понял, что эмбеддинги — это просто координаты смысла
- /journal не понимаю, зачем в RAG нужен реранкер
- /journal хочу потом попробовать собрать поиск по своим заметкам
Как установить journal
1Через Skills CLI (Vercel)
npx skills add TakaGoto/rag-learning-academy --skill journal -a claude-code2Вручную: положить файлы
~/.claude/skills/journal/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/journal/
1Через Skills CLI (Vercel)
npx skills add TakaGoto/rag-learning-academy --skill journal -a codex2Вручную: положить файлы
.agents/skills/journal/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add TakaGoto/rag-learning-academy --skill journal -a cursor2Вручную: положить файлы
.cursor/skills/journal/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install TakaGoto/rag-learning-academy journal2Вручную: положить файлы
.github/skills/journal/SKILL.md1Через Skills CLI (Vercel)
npx skills add TakaGoto/rag-learning-academy --skill journal -a gemini-cli2Командой платформы
gemini skills install https://github.com/TakaGoto/rag-learning-academy --path .claude/skills/journalВручную: положить файлы
.devin/skills/journal/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add TakaGoto/rag-learning-academy --skill journal -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о journal
Как установить journal в Claude Code?
Выполните npx skills add TakaGoto/rag-learning-academy --skill journal -a claude-code, затем скилл окажется в ~/.claude/skills/journal/SKILL.md.
Что делает journal?
Принимает короткий текст, определяет его категорию и дописывает запись в progress/journal.md, сохраняя ваши формулировки.
Куда сохраняются записи?
В файл progress/journal.md в текущем каталоге; если файла нет, скилл его создаст.
Исходный текст
SKILL.md · MIT
--- name: journal description: "Write a quick note about what you learned or what confused you" --- # Journal: Capture Your Thoughts A lightweight way for learners to jot down what clicked, what confused them, or what they want to revisit. These notes feed back into the curriculum director's recommendations. ## Step 1: Get the Entry If the learner provides text with the command (e.g., `/journal embeddings finally make sense — it's just coordinates in meaning space`), use that directly. If no text is provided, prompt: "What's on your mind? Could be something that clicked, something confusing, a question for later, or just a note to yourself." ## Step 2: Categorize Tag the entry with one of these categories based on content: - **insight** — something that clicked or a connection they made - **confusion** — something they don't understand yet - **question** — something they want to explore later - **idea** — a project idea or experiment they want to try - **note** — general observation ## Step 3: Save the Entry Append to `progress/journal.md`. Create the file if it doesn't exist. Format: ```markdown ### [date] — [category] [their entry text] ``` Keep their original words. Don't rewrite or polish — this is their voice, their notes. ## Step 4: Brief Response Keep it short. Respond based on the category: - **insight**: Acknowledge it. "Solid mental model. That analogy will serve you well when things get more complex." - **confusion**: Normalize it and offer help. "That's a common sticking point. Want me to `/explain [topic]` from a different angle?" - **question**: Acknowledge and bookmark. "Good question. We'll hit that in [relevant module]. Or run `/explain [topic]` now if you're curious." - **idea**: Encourage it. "That's worth trying. When you're ready, `/sandbox` can help you prototype it." - **note**: Just confirm. "Noted." Don't turn this into a teaching moment unless they ask. The journal is for *them*, not for the system. Suggest next steps if appropriate: - `/lesson` to continue learning - `/roadmap` to check your progress - `/explain [topic]` if a confusion entry points to a specific concept
© TakaGoto · MIT · TakaGoto/rag-learning-academy
