Grimoire

Grimoire — turn a PDF/document/raw text into reading notes + a reusable skill pack in one parse. Auto-classifies book/paper/document, scaffolds type-specific notes for an Obsidian vault, and mines per-source skills merged per book/course. Built on the MinerU parsing API (OCR, formula/table, batch). Scripts never call an LLM and never write the vault; skill install is OPT-IN (--install / scripts/skill-install.sh) and deliberately crosses the candidate-only boundary by explicit user request, recorded in the manifest. Raw text → skill via --from-text; cross-agent install + management via the grim

8 stars 2 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add LeoLin990405/grimoire-skill --skill grimoire

Manual install

git clone --depth 1 https://github.com/LeoLin990405/grimoire-skill.git /tmp/grimoire-skill
mkdir -p ~/.claude/skills
cp -r /tmp/grimoire-skill/. ~/.claude/skills/grimoire

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Grimoire · 魔典 — Document → Notes + Skill Pack

> One source, parsed once, woven into typed reading notes (→ Obsidian) and a
> per-source skill pack. Primary entry point: `scripts/grimoire.sh`.
> Full product overview and bilingual docs: see [README.md](README.md).
>
> The sections below are the underlying MinerU parsing API reference that the
> `grimoire` toolchain is built on.

### Flow: Markdown first, the grimoire is opt-in · 先转 MD,魔典是可选续跑

The pipeline is **gated**, not automatic:

1. **Always first → Markdown.** A source becomes Markdown via `pdf2md` /
   `mineru-local` (or any MinerU parse). For many requests this is the whole
   job — **stop here**. Do not auto-run notes/skill mining.
2. **Opt-in → the grimoire.** Only when the user actually wants reading notes
   and/or a packaged skill, continue **from that Markdown** with
   `grimoire.sh --from-markdown <md>`. Nothing is re-uploaded; the parse is
   skipped. `--only notes|skills|both` is the second opt-in: notes only,
   the skill (engineering-prompt) packaging only, or both.
3. **`--only both` is two-stage, not parallel.** Stage 1 writes the
   type-specific notes from the source. Stage 2 is a deliberate
   **re-learning pass (重复学习)**: the agent re-reads the notes it just
   wrote and mines the skill pack **from those notes' knowledge points**,
   not the raw source (`source-markdown/` is then only for evidence
   anchors). `--only skills` (no notes) keeps mining from the source.

Read the full skill on GitHub

Details

Skill name: grimoire
Repository: LeoLin990405/grimoire-skill
License: MIT
Repo updated: 9 July 2026

FAQ

What does the Grimoire skill do?

How do I install the Grimoire skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add LeoLin990405/grimoire-skill --skill grimoire. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Grimoire popular?

It lives in LeoLin990405/grimoire-skill, which has 8 GitHub stars and 2 forks.

Related skills

Adhd Operating System

brkhzn/adhd-operating-system

Pervasive filter adapting all Claude interactions to inattentive ADHD cognition. Affects BOTH response formatting/structure AND content recommendations. Trigger aggressively for: productivity, organization, project management, task management, learning, studying, note-taking, communication, email, meetings, habits, routines, daily planning, time management, tool selection, workspace setup, career decisions, writing, creative work, prioritization, or anything involving executive function, working memory, attention, motivation, or emotional regulation. Also trigger for mentions of ADHD, focus, d

Productivity & Notes

Pbi Project Hub

gusbavia/pbi-project-hub

Build a complete Power BI project delivery vault in Obsidian — from client discovery to production sign-off. Asks 8 questions about your practice and first project, then generates folder structure, design system, technical reference, DAX/HTML guide, discovery framework, sprint board, templates, and live dashboards. Triggers on "Power BI project hub", "PBI project setup", "set up my Power BI practice", "consultant vault", "Power BI delivery system". Do NOT use for generic Obsidian vaults, non-Power BI projects, or single-file templates.

Productivity & Notes

Anki Connect

crisak/anki-connect-skill

Manipulate Anki flashcards via curl using the Anki-Connect API. Create cards, manage decks, search notes, customize note types, and control Anki entirely through HTTP requests.

Productivity & Notes

Trace to Practice

wssfk12138/trace-to-practice

Periodically distill task histories into evidence-backed workflow improvements, reusable skills, scoped agent rules, persistent memory, and user habit suggestions while controlling review cost. Use for conversation retrospectives, recurring agent-error analysis, or 对话蒸馏/工作流复盘 across tasks. Do not use for a simple one-chat summary or ML model knowledge distillation.

Productivity & Notes

Codex Automation Audit

adonis-cyril/codex-automation-audit

Audit recent Codex automation and personal skill runs, compare task behavior with prompts and local docs, then prepare numbered patch-ready recommendations without changing files during the scheduled run.

Productivity & Notes

Rich Elicitation

CyberZenithX/Rich-Elicitation-Skill

Use this skill whenever Claude is about to help with any task that has multiple reasonable approaches, unclear requirements, personal preferences, or ambiguous scope. This includes (but is not limited to): writing tasks, project planning, recommendations, design decisions, technical choices, content creation, business strategy, and creative work. Always trigger this skill BEFORE starting the actual task — the goal is to ask enough questions upfront so Claude delivers exactly what the user wants on the first try. Do NOT trigger for simple factual lookups, math, or tasks where intent is complete

Productivity & Notes

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.