# Send mycroft to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mycroft",
    "name": "mycroft",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/fabe/mycroft",
    "canonicalUrl": "https://clawhub.ai/fabe/mycroft",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mycroft",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mycroft",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "mycroft",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-12T08:42:41.622Z",
      "expiresAt": "2026-05-19T08:42:41.622Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mycroft",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mycroft",
        "contentDisposition": "attachment; filename=\"mycroft-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "mycroft"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mycroft"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mycroft",
    "downloadUrl": "https://openagent3.xyz/downloads/mycroft",
    "agentUrl": "https://openagent3.xyz/skills/mycroft/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mycroft/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mycroft/agent.md"
  }
}
```
## Documentation

### 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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: fabe
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-12T08:42:41.622Z
- Expires at: 2026-05-19T08:42:41.622Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mycroft)
- [Send to Agent page](https://openagent3.xyz/skills/mycroft/agent)
- [JSON manifest](https://openagent3.xyz/skills/mycroft/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mycroft/agent.md)
- [Download page](https://openagent3.xyz/downloads/mycroft)