Shiori-v1
Open-source AI study companion — Google Classroom sync, Gemini AI plans, SRS flashcards, GPA predictor, AI quiz, MCP server for Claude Code. Try demo at shiori-v1.vercel.app
Install / Use
claude mcp add kaorii-ako -- npx -y github:kaorii-ako/Shiori-v1If the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
OperationsSupported Platforms
Our assessment of Shiori-v1
Shiori-v1 scores 68/100 on our quality scale, 705th of 756 Operations skills we index.
Its MCP Server is 2.1 KB long, split into 7 sections with 2 code examples: moderately detailed.
It has 48 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-21 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 95/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-24. Automated pattern scan on 2026-09-24. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
Shiori-v1 compared with similar skills
All 4 of these similar skills score higher than Shiori-v1; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| Shiori-v1 (this skill)by kaorii-ako | 68 | 48 | 3mo ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 109.2k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 78.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 47.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 97.9k | today | MCP Server |
Frequently asked questions
- How do I install Shiori-v1?
- Run
claude mcp add kaorii-ako -- npx -y github:kaorii-ako/Shiori-v1. The install tabs above show the steps for each supported agent. - Which AI agents does Shiori-v1 work with?
- It is written for Claude Code, Claude Desktop and Gemini CLI, as a MCP Server file. Other agents that read the same format can often use it too.
- Is Shiori-v1 safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 95/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is Shiori-v1 still maintained?
- The repository was last updated about 3 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubShiori (栞)
An AI study companion for students who actually care about their grades. Quizzes, flashcards, grade tracking, and study planning in one app — bring your own free Gemini API key, no subscription needed.
Try the demo — no account or API key required.
Features
- AI quiz generator and spaced-repetition flashcards from your notes
- Weighted grade calculator with GPA prediction
- Assignment manager with due dates and priorities
- Markdown notes with live preview
- Pomodoro focus mode linked to tasks
- Study plans generated day-by-day from your syllabus
- Habit tracker, XP/leveling, and a friends leaderboard
- Keyboard-driven navigation (
g h,g a,g n,g q...)
Getting started
Fastest: just open the demo.
Deploy your own:
Self-host:
git clone https://github.com/kaorii-ako/Shiori-v1.git
cd Shiori-v1
cp .env.example .env # add your Supabase URL + anon key
npm install
npm run dev
You'll need a free Supabase project (URL + anon key from Settings → API) and, optionally, a free Gemini API key for the AI features.
Stack
React + Vite + Zustand on the frontend, Supabase for auth and data, Gemini 1.5 Flash for AI (called client-side with your own key), deployed on Vercel.
Structure
Shiori-v1/
├── client/ React + Vite frontend
├── server/ Express backend (Stripe webhooks only)
├── extension/ Chrome MV3 extension
└── supabase/ DB schema + setup
Contributing
PRs welcome. Start with good first issues or read CONTRIBUTING.md.
License
MIT — use it however you like.
Built by Tawin Tangsukson. Star it if it's useful to you.
Related Skills
Agent-Reach
109.2kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
78.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
47.8kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Scrapling
97.9k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.