search-letters

Search WW1 Danish letters from static JSON endpoints for client-side filtering.

1|Updated Jun 9, 2020
One-click install
npx skills add https://github.com/dalager/jernkorsetbreve --skill search-letters
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: search-letters
Source: https://github.com/dalager/jernkorsetbreve/tree/main/apps/website/public/.well-known/agent-skills/search-letters
Command: npx skills add https://github.com/dalager/jernkorsetbreve --skill search-letters

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Makes it easy to discover, filter, preview, and read letters from a 665-item WW1-era Danish correspondence collection without any server API; all search and retrieval are performed by fetching and filtering static JSON endpoints client-side.

Core Features & Use Cases

  • Metadata filtering: Narrow the corpus by date range, sender, recipient, or place using the lightweight letter-summaries.json.
  • Quick previews and full text: Show 200-character snippets from search-snippets.json for fast triage, and retrieve full markdown letter pages or bulk plain-text via search-corpus.json.
  • Semantic and thematic exploration: Use precomputed related-letters.json for cosine-similarity based recommendations and topic-clusters.json for thematic browsing and representative samples.
  • Use Case: A researcher can find all letters mentioning a battle, preview them quickly, and then fetch full texts for a close reading and thematic aggregation.

Quick Start

Find letters by Peter Mærsk between 1914-08-01 and 1914-12-31, show 200-character previews for the matches, and fetch the full markdown for the top three results.

Frequently Asked Questions about search-letters

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

FAQPage Schema
How do I search a historical text corpus without a backend API?

You can search a historical text corpus without a backend API by fetching and filtering precomputed static JSON endpoints client-side. This approach retrieves letter summaries, snippets, and semantic relationships directly in the browser for fast exploration.

How do I filter historical Danish letters by date, sender, and recipient?

You filter historical Danish letters by date, sender, and recipient using the letter-summaries.json endpoint. This static file provides the necessary metadata for client-side filtering across the 665-letter WW1 correspondence collection.

Can I perform semantic similarity searches on a static document collection?

Yes, you can perform semantic similarity searches on a static document collection by utilizing a precomputed related-letters.json file. This file contains cosine-similarity based recommendations that allow client-side thematic exploration without server-side processing.

What's the best way to preview full-text letters before fetching the entire document?

The best way to preview full-text letters before fetching the entire document is by using the search-snippets.json endpoint. It provides 200-character snippets for fast triage, allowing you to quickly scan matches before retrieving full markdown pages.

Does this semantic search approach work for browsing thematic clusters in a historical corpus?

Yes, this semantic search approach works for browsing thematic clusters in a historical corpus by loading the precomputed topic-clusters.json file. It enables thematic browsing and retrieval of representative samples entirely client-side.

Do I need a server to retrieve full markdown pages from a static JSON corpus?

No, you do not need a server to retrieve full markdown pages from a static JSON corpus. The Skill supports content negotiation to fetch individual markdown letter pages directly from static endpoints alongside the bulk plain-text search-corpus.json file.