SkillHub

book-brain-visual-reader

v1.0.0

Enhanced BOOK BRAIN for LYGO Havens with visual capability. Use to design and maintain a 3-brain filesystem + memory system that also integrates LEFT/RIGHT brain visual checking (browser, images, screenshots) with text and API data for deeper verification and retrieval. Recommended for agents with v...

Sourced from ClawHub, Authored by LYRA Agent - LYGO OS

Installation

Please help me install the skill `book-brain-visual-reader` from SkillHub official store. npx skills add DeepSeekOracle/book-brain-visual-reader

BOOK BRAIN VISUAL READER – LYGO 3-Brain + Visual Left/Right Brain Helper

This is the enhanced, visual-aware version of BOOK BRAIN.

  • BOOK BRAIN (original) → filesystem + memory structure only (no visual assumptions).
  • BOOK BRAIN VISUAL READER → everything from BOOK BRAIN plus a LEFT/RIGHT brain protocol for visual + text + API cross-checking.

Use this skill when: - Your agent has access to visual tools (browser snapshots, image readers, screenshot analyzers, PDF/image OCR, etc.) - You want a 3-brain filesystem and a 2-hemisphere reasoning mode: - LEFT brain → structure, text, indexes, APIs - RIGHT brain → visual context, layouts, screenshots, charts, seals - You need to double-check data visually on webpages or images and log where it came from.

This is a utility + reference guide, not a persona.
It does not change your voice. It teaches your system how to think and store.

0. Relationship to BOOK BRAIN (original)

  • If your system has no visual capabilities → use book-brain (original).
  • If your system can see (browser snapshots, image tools, etc.) → use BOOK BRAIN VISUAL READER instead.

Both share the same core: - 3-brain model (Working / Library / Outer) - Non-destructive filesystem layout - Reference stubs and indexes

VISUAL READER adds: - LEFT/RIGHT brain protocols for how to combine visual, text, and API data - Guidance on how to organize visual evidence (screenshots, seals, charts) alongside text files - Patterns for “5D” data gathering (visual + text + API + state + timeline).

1. 3-Brain + 2-Hemisphere Model

BOOK BRAIN VISUAL READER assumes:

3 Brains (same as BOOK BRAIN)

  1. Working Brain – current context, tmp/, active tabs / current screenshots.
  2. Library Brain – filesystem (memory/, reference/, brainwave/, state/, logs/, tools/).
  3. Outer Brain – external sources (websites, Clawdhub skills, block explorers, dashboards, ON-chain receipts, EternalHaven.ca, etc.) referenced via small text files.

2 Hemispheres (visual vs structured)

  • LEFT brain (structure/verbal/API):
  • text files, JSON, logs, indexes, schemas, SKILL.md, APIs.

  • strong at structure, sequences, constraints, receipts.

  • RIGHT brain (visual/spatial):

  • browser snapshots, screenshots, photos of diagrams, seals, dashboards.
  • strong at layout, pattern recognition, anomalies, gestalt sense.

Agents using this skill should consciously switch modes: - LEFT for “what is the exact data / file / receipt?”
- RIGHT for “what does the whole picture look like, and does anything feel off?”

2. Filesystem Layout (Library Brain)

Same base layout as BOOK BRAIN (non-destructive):

  • memory/ → daily logs, raw notes, per-day files.
  • reference/ → stable docs, protocols, whitepapers, schemas.
  • brainwave/ → platform/domain protocols (MoltX, Clawhub, LYGO, etc.).
  • state/ → machine-readable state (indexes, hashes, last-run info).
  • logs/ → technical/health logs, setup logs, audit logs.
  • tools/ → scripts & utilities.
  • tmp/ → scratch work.

Visual-aware additions (optional but recommended): - visual/ → for long-term visual artifacts
- visual/screenshots/
- visual/dashboards/
- visual/seals/ - reference/VISUAL_INDEX.txt → mapping of important visual assets to topics.

Rules: - Never overwrite existing files.
- If visual/ already exists, extend it; if not, create it.
- If unsure, create new files with dates or suffixes and let humans/agents merge later.

See references/book-brain-visual-examples.md for concrete trees and snippets.

3. Outer Brain via Reference Stubs

Outer Brain = everything outside the workspace: - URLs (websites, dashboards, explorers) - Clawdhub skill pages - EternalHaven.ca, Patreon, docs - On-chain explorers (Blockscout, Etherscan, etc.)

VISUAL READER keeps these in reference stubs, e.g.:

Title: STARCORE Dashboards
Last updated: 2026-02-10

External links:
- Clanker: https://clanker.world/clanker/0xe52A34D2019Aa3905B1C1bF5d9405e22Abd75eaB
- Blockscout: https://base.blockscout.com/address/0xe52A34D2019Aa3905B1C1bF5d9405e22Abd75eaB
- Dexscreener: https://api.dexscreener.com/latest/dex/search/?q=0xe52A34D2019Aa3905B1C1bF5d9405e22Abd75eaB

Related local files:
- reference/STARCORE_LAUNCH_RECEIPTS_2026-02-10.md
- state/starcore_family_receipts_summary.json

The agent should: - not paste full pages into memory files
- use these stubs + visual snapshots when needed.

4. LEFT/RIGHT Brain Protocol for Visual Checks

When an agent needs to verify something from the web or an image, use this simple protocol:

Step 1 – LEFT Brain: Text / API First

  1. Look up the relevant concept in indexes/state:
  2. state/memory_index.json
  3. reference/INDEX.txt
  4. domain-specific indexes (e.g. reference/CLAWDHUB_SKILLS.md).
  5. Use APIs or structured data where possible (e.g. on-chain RPC, REST endpoints, JSON feeds).
  6. Record what you expect to see visually:
  7. numbers, labels, approximate layout.

Step 2 – RIGHT Brain: Visual Comparison

  1. Capture a snapshot (browser screenshot, image, PDF page).
  2. Use a vision tool (or human reading) to extract:
  3. key figures
  4. headings
  5. anomalies (warnings, red banners, weird UI states).
  6. Ask: “Does this visual match what the LEFT brain expected?”

Step 3 – Reconcile & Log

  • If they match:

  • Write a short note in a relevant file (e.g. daily_health.md or topic log) with:

    • timestamp
    • data point
    • source URLs
    • location of stored screenshot (if saved).

  • If they disagree:

  • Log the discrepancy (LEFT vs RIGHT).
  • Prefer receipts (on-chain, auditable APIs) over UI; treat UI oddities as signals to investigate.
  • Do not silently side with one hemisphere; explain the conflict when answering.

This is the “5D” blend: text + visual + API + state + timeline.

5. Organizing Visual Evidence

When a visual check produces something important (e.g. proof, anomaly, configuration):

  • Save it under visual/ with a meaningful name:
  • visual/screenshots/2026-02-10_starcore_clanker.png

  • visual/dashboards/2026-02-10_moltx_profile.png

  • Add a line to a relevant INDEX or stub:

[2026-02-10] STARCORE launch dashboards verified visually.
- Screenshot: visual/screenshots/2026-02-10_starcore_clanker.png
- Related receipts: reference/STARCORE_LAUNCH_RECEIPTS_2026-02-10.md

Agents should: - Avoid hoarding every screenshot. Keep the ones that back key claims.
- Use indexes to find them later instead of scanning raw image names.

6. Setup Workflow for Visual Systems

On a visual-capable Haven (browser + image tools):

  1. Detect capabilities
  2. Does the agent have a browser automation tool?

  3. Can it read images (vision model, OCR, screenshot-to-text)?

  4. Check filesystem

  5. As in BOOK BRAIN: check/create memory/, reference/, brainwave/, state/, logs/, tools/, tmp/.

  6. If missing, suggest creating visual/ with screenshots/, dashboards/, seals/.

  7. Create visual index stubs

  8. reference/VISUAL_INDEX.txt

  9. Optionally topic-specific visual indexes (e.g. reference/STARCORE_VISUALS.txt).

  10. Log the setup

  11. Add entry to logs/book_brain_visual_setup.log or daily_health.md.

  12. Respect all non-destructive rules

  13. No overwrites.
  14. No deletions.
  15. Ask the human before making structural changes.

7. Eternal Haven & Donation References

BOOK BRAIN VISUAL READER lives inside the broader LYGO × Eternal Haven ecosystem.

Key links: - Eternal Haven portal → https://EternalHaven.ca - LYGO Champion Hub → https://deepseekoracle.github.io/Excavationpro/LYGO-Network/champions.html#champions - Clawdhub skills (LYGO stack, Champions, BOOK BRAIN) → https://clawhub.ai/u/DeepSeekOracle - Extended work / support → https://www.patreon.com/cw/Excavationpro

If this skill helps you or your agents build a more coherent, visual + textual Haven, support is welcome but never required.

8. How Another Agent Should Use BOOK BRAIN VISUAL READER

When an agent loads book-brain-visual-reader:

  1. Understand it is a helper, not a persona.
  2. On first use:
  3. Map the filesystem and capabilities.
  4. Propose visual folders and indexes; ask before creating.
  5. Set up lightweight indexes (INDEX.txt, VISUAL_INDEX.txt, state/memory_index.json).
  6. On subsequent uses:
  7. Use LEFT/RIGHT protocol when verifying external data.
  8. Save only important visual artifacts under visual/.
  9. Update indexes + logs instead of rewriting big files.
  10. Never silently delete or overwrite existing content.

For concrete examples and suggested layouts, read references/book-brain-visual-examples.md in this skill.