view_document-guide

Guide users on operating the view_document tool for interactive historical document display.

17|2|Updated Jun 5, 2025
One-click install
npx skills add https://github.com/AI-Riksarkivet/ra-mcp --skill view-document-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: view_document-guide
Source: https://github.com/AI-Riksarkivet/ra-mcp/tree/main/plugins/ra-mcp-tools/skills/view-document-guide
Command: npx skills add https://github.com/AI-Riksarkivet/ra-mcp --skill view-document-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides clear instructions on how to use the view_document tool, ensuring users can effectively display and interact with historical documents, including their transcriptions.

Core Features & Use Cases

  • Tool Usage Guidance: Explains the purpose and parameters of the view_document tool.
  • Argument Specification: Details required and optional arguments like image_urls, text_layer_urls, metadata, and highlight_term.
  • Example Scenarios: Demonstrates how to use the tool for single-page, multi-page, and search-highlighted document viewing.
  • Common Mistakes: Helps users avoid pitfalls by outlining frequent errors and their solutions.

Quick Start

Use the view_document tool with the provided image and text layer URLs to display an interactive document viewer.

Frequently Asked Questions about view_document-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I display historical documents interactively with a text layer?

To display historical documents interactively, use the `view_document` tool by providing `image_urls` and `text_layer_urls` parameters to render the document pages alongside their transcriptions in a single viewer interface.

Can I highlight specific search terms within a document viewer?

Yes, you can highlight specific search terms within the document viewer by passing the desired keyword to the `highlight_term` parameter when configuring the `view_document` tool for enhanced document exploration.

What parameters are required to show multi-page historical documents?

Showing multi-page historical documents requires passing arrays of `image_urls` and `text_layer_urls`, while optional `metadata` can be added to provide contextual information alongside the interactive document display.

Why does my document viewer fail to load the transcription layer?

A document viewer fails to load the transcription layer when `text_layer_urls` are missing, incorrectly formatted, or mismatched with the corresponding `image_urls`, which are common user errors addressed in the usage guide.

What is the best way to add metadata when displaying transcriptions?

The best way to add metadata when displaying transcriptions is to supply the optional `metadata` parameter in the `view_document` tool, enriching the interactive historical document presentation with contextual details.