How do I install the Mycroft skill?

Run npx skillmds@latest add modbender/mycroft in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Mycroft skill do?

EPUB and ebook ingestion, local vector index, and Q&A CLI for books. It is listed under Coding & Dev Tools on SkillMD.

Is Mycroft safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mycroft?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mycroft free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mycroft?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mycroft by modbender — Agent Skill

Name: Mycroft
Rating: 4.5 (4 reviews)
Author: modbender

File contents

mycroft

Use mycroft to ingest EPUBs and ebooks, build a local vector index, and ask questions about a book.

Setup (once)

export OPENAI_API_KEY="..."
mycroft config onboard
mycroft config resolve

Common commands

List books: mycroft book list
Ingest EPUB: mycroft book ingest /path/to/book.epub
Ingest with summaries: mycroft book ingest /path/to/book.epub --summary
Ingest with batch embeddings (50% cheaper): mycroft book ingest /path/to/book.epub --batch
Ingest with batch summaries + embeddings: mycroft book ingest /path/to/book.epub --batch --summary
Resume batch ingestion: mycroft book ingest resume <id>
Check ingestion status: mycroft book ingest status <id>
Show metadata: mycroft book show <id>
Ask a question: mycroft book ask <id> "What is the main conflict?"
Search passages: mycroft book search <id> "mad hatter" --top-k 5
Delete book: mycroft book delete <id> --force
Start chat: mycroft chat start <id>
Ask in session: mycroft chat ask <session> "What does this foreshadow?"
Continue chat: mycroft chat repl <session>

Notes

Use mycroft config path to find the config file location.
book ask and book search require embeddings and an OPENAI_API_KEY.
Chat commands require embeddings and an OPENAI_API_KEY.
Prefer book search and synthesize answers yourself before using book ask.
Summaries increase ingestion time and cost significantly; enable --summary only when needed.
Use --batch to run embeddings and summaries via the OpenAI Batch API at 50% cost; results may take up to 24 hours. When combined with --summary, summaries are batched first, then embeddings on resume.
After --batch ingestion, use mycroft book ingest status <id> to check progress and mycroft book ingest resume <id> to complete indexing.
If a non-batch ingest is interrupted, use mycroft book ingest resume <id> to continue from the last saved chunk.
If a batch fails, resume automatically re-submits it.
For scripted runs, avoid interactive flags like --manual or omit confirmations with --force.

---name: mycroftdescription: EPUB and ebook ingestion, local vector index, and Q&A CLI for books.--- # mycroft Use `mycroft` to ingest EPUBs and ebooks, build a local vector index, and ask questions about a book. Setup (once) - `export OPENAI_API_KEY="..."` - `mycroft config onboard` - `mycroft config resolve` Common commands - List books: `mycroft book list` - Ingest EPUB: `mycroft book ingest /path/to/book.epub` - Ingest with summaries: `mycroft book ingest /path/to/book.epub --summary` - Ingest with batch embeddings (50% cheaper): `mycroft book ingest /path/to/book.epub --batch` - Ingest with batch summaries + embeddings: `mycroft book ingest /path/to/book.epub --batch --summary` - Resume batch ingestion: `mycroft book ingest resume <id>` - Check ingestion status: `mycroft book ingest status <id>` - Show metadata: `mycroft book show <id>` - Ask a question: `mycroft book ask <id> "What is the main conflict?"` - Search passages: `mycroft book search <id> "mad hatter" --top-k 5` - Delete book: `mycroft book delete <id> --force` - Start chat: `mycroft chat start <id>` - Ask in session: `mycroft chat ask <session> "What does this foreshadow?"` - Continue chat: `mycroft chat repl <session>` Notes - Use `mycroft config path` to find the config file location. - `book ask` and `book search` require embeddings and an `OPENAI_API_KEY`. - Chat commands require embeddings and an `OPENAI_API_KEY`. - Prefer `book search` and synthesize answers yourself before using `book ask`. - Summaries increase ingestion time and cost significantly; enable `--summary` only when needed. - Use `--batch` to run embeddings and summaries via the OpenAI Batch API at 50% cost; results may take up to 24 hours. When combined with `--summary`, summaries are batched first, then embeddings on resume. - After `--batch` ingestion, use `mycroft book ingest status <id>` to check progress and `mycroft book ingest resume <id>` to complete indexing. - If a non-batch ingest is interrupted, use `mycroft book ingest resume <id>` to continue from the last saved chunk. - If a batch fails, `resume` automatically re-submits it. - For scripted runs, avoid interactive flags like `--manual` or omit confirmations with `--force`.

Frequently asked questions

Mycroft