docs(skills): language learning, long sources, note size and atomic cards #6

Open
yuuhikaze wants to merge 3 commits from docs/language-notes into master
Owner

Rules that were missing when an Open WebUI model generated notes and cards from a Japanese grammar book (Tae Kim). The result:

  • one note per chapter;
  • a rewrite that lost three quarters of a chapter;
  • English and draft leftovers in the notes;
  • examples without readings;
  • reversed cards whose front is a question, and a 10-hole cloze;
  • the whole book read through the knowledge-base viewer before anything was written;
  • a claim that the kioku tools were unavailable, made without calling them.

NOTES.md

  • SIZE: one note per section of the source; the chapter is the category note.
  • REWRITING: get the content before overwriting, never lose coverage, recover from revisions.
  • Final pass before saving: English prose, draft leftovers, untranslated examples, typos.
  • Headings: no source section numbers; the mind map summarizes content, never work status.
  • TREE: subject → source → chapter → note for subjects with several sources; #displayMode=preview next to the icon.

CARDS.md

  • ATOMIC CARDS: one fact per card, no cards about the source, cloze notes with at most 3 holes.
  • Never "and reversed" when the front is a question.

BOOK-NOTES.md: SOURCES LONGER THAN A CHAPTER

  • pdftotext once in the sandbox, NFKC normalization (PDFs store 食 as the radical ⾷).
  • A table of contents mapped to line ranges.
  • A chapter-by-chapter loop with a coverage check, and resuming from the first missing section.
  • The doc becomes a template, for {{ sandbox_dir }}.

LANGUAGES.md (new, kioku-languages)

  • Example sentences with translation, furigana as HTML ruby, grammar patterns in code with fixed Spanish term names, and kinds of cards.
  • Ruby renders in the Trilium client and in Anki. The share page strips it unless ruby is in Trilium's allowedHtmlTags option; I tested both on a local Trilium 0.104.1.

skills.toml

  • The kioku model's system prompt: never say a tool is unavailable without calling it.

Applied to

  • The Tae Kim notes, chapters 2–4: 41 notes, 1345 ruby readings.
  • 161 cards under Japonés::Tae Kim::*.

After merging, run nix run path:.#publish-skills.

🤖 Generated with Claude Code

Rules that were missing when an Open WebUI model generated notes and cards from a Japanese grammar book (Tae Kim). The result: - one note per chapter; - a rewrite that lost three quarters of a chapter; - English and draft leftovers in the notes; - examples without readings; - reversed cards whose front is a question, and a 10-hole cloze; - the whole book read through the knowledge-base viewer before anything was written; - a claim that the kioku tools were unavailable, made without calling them. **NOTES.md** - SIZE: one note per section of the source; the chapter is the category note. - REWRITING: get the content before overwriting, never lose coverage, recover from revisions. - Final pass before saving: English prose, draft leftovers, untranslated examples, typos. - Headings: no source section numbers; the mind map summarizes content, never work status. - TREE: subject → source → chapter → note for subjects with several sources; `#displayMode=preview` next to the icon. **CARDS.md** - ATOMIC CARDS: one fact per card, no cards about the source, cloze notes with at most 3 holes. - Never "and reversed" when the front is a question. **BOOK-NOTES.md**: SOURCES LONGER THAN A CHAPTER - `pdftotext` once in the sandbox, NFKC normalization (PDFs store 食 as the radical ⾷). - A table of contents mapped to line ranges. - A chapter-by-chapter loop with a coverage check, and resuming from the first missing section. - The doc becomes a template, for `{{ sandbox_dir }}`. **LANGUAGES.md (new, `kioku-languages`)** - Example sentences with translation, furigana as HTML ruby, grammar patterns in code with fixed Spanish term names, and kinds of cards. - Ruby renders in the Trilium client and in Anki. The share page strips it unless `ruby` is in Trilium's `allowedHtmlTags` option; I tested both on a local Trilium 0.104.1. **skills.toml** - The kioku model's system prompt: never say a tool is unavailable without calling it. **Applied to** - The Tae Kim notes, chapters 2–4: 41 notes, 1345 ruby readings. - 161 cards under `Japonés::Tae Kim::*`. After merging, run `nix run path:.#publish-skills`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs(skills): language learning notes and cards with furigana
All checks were successful
CI / check (pull_request) Successful in 17s
cc0c720143
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
All checks were successful
CI / check (pull_request) Successful in 17s
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 'docs/language-notes:docs/language-notes'
git switch 'docs/language-notes'

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch 'master'
git merge --no-ff 'docs/language-notes'
git switch 'docs/language-notes'
git rebase 'master'
git switch 'master'
git merge --ff-only 'docs/language-notes'
git switch 'docs/language-notes'
git rebase 'master'
git switch 'master'
git merge --no-ff 'docs/language-notes'
git switch 'master'
git merge --squash 'docs/language-notes'
git switch 'master'
git merge --ff-only 'docs/language-notes'
git switch 'master'
git merge 'docs/language-notes'
git push origin 'master'
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
yuuhikaze/kioku!6
No description provided.