From aa70dd2f1255e09c9313c3dc97c3d00f0f5f6e56 Mon Sep 17 00:00:00 2001 From: lszoszk Date: Sat, 10 Oct 2026 20:27:36 +0200 Subject: [PATCH 1/2] docs: point readers and AI assistants to the UNHRDB Claude skills The README, llms.txt and the About page now describe the Claude plugin in lszoszk/mcp-unhrdb (connector + four research skills) and how to install it. llms.txt also gains a short section on using the database from an AI assistant: the connector address, its tools, and the two rules that matter most (quote verbatim with symbol and paragraph; bare search words are all required). Co-Authored-By: Claude Opus 5.5 --- README.md | 8 ++++++++ docs/index.html | 20 ++++++++++++++++++++ docs/llms.txt | 7 +++++++ 3 files changed, 35 insertions(+) diff --git a/README.md b/README.md index 00afc48..c18d22e 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,8 @@ original document symbol and context. - **Live application:** https://lszoszk.github.io/generalcomments/ - **General Comments dataset:** https://huggingface.co/datasets/lszoszk/treaty-bodies-general-comments - **MCP integration:** https://github.com/lszoszk/mcp-unhrdb +- **Claude skills:** a plugin with the connector and four research skills — + [install](https://github.com/lszoszk/mcp-unhrdb#skills-for-claude) - **Methodology:** [METHODOLOGY.md](METHODOLOGY.md) - **Document status audit:** [STATUS_AUDIT.md](STATUS_AUDIT.md) @@ -61,6 +63,12 @@ the data. Committee passages rather than generated legal answers. - Exposes General Comments and UHRI recommendations to MCP-capable clients via the companion `mcp-unhrdb` server. +- Ships [Claude skills](https://github.com/lszoszk/mcp-unhrdb#skills-for-claude) + for researching UN human rights law with verbatim, paragraph-cited sources, + checking UN citations in a text, analysing treaty-body case law, and searching + recommendations to States. Install in Claude Code with + `/plugin marketplace add lszoszk/mcp-unhrdb` and + `/plugin install unhrdb@mcp-unhrdb`. ## Run locally diff --git a/docs/index.html b/docs/index.html index e4ab573..bb5a5cc 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1579,6 +1579,26 @@

MCP server — query it from an AI assistant

+
+

Claude skills — UN research the careful way

+

+ A Claude plugin bundles the connector with four skills that teach the + assistant how to work with these sources: choose the right kind of + document (interpretation, case, expert opinion, recommendation), search + the way the index works, quote verbatim and pin every + statement to a UN symbol and paragraph. un-human-rights-research + answers questions of UN human rights law; + un-citation-check verifies the UN citations in a + draft, brief or AI answer; treaty-body-case-law + reads decisions on individual complaints from their operative paragraph; + uhri-recommendations searches recommendations to + States. In Claude Code: /plugin marketplace add lszoszk/mcp-unhrdb, + then /plugin install unhrdb@mcp-unhrdb. For claude.ai and + other set-ups see + github.com/lszoszk/mcp-unhrdb#skills-for-claude. +

+
+

Usage statistics

diff --git a/docs/llms.txt b/docs/llms.txt index 859345e..c3d2674 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -23,6 +23,12 @@ General Comments are authoritative interpretations of a treaty by its monitoring - Cite the underlying UN document by its symbol and paragraph (e.g. CCPR/C/GC/36, para. 12); the official text is at https://docs.un.org/en/. - Cite the database itself as: Szoszkiewicz, Ł., & Kowalska, Z. (2026). UNHRDB — UN Human Rights Database (Version 2.1.0). Zenodo. https://doi.org/10.5281/zenodo.10495719 +## Using it from an AI assistant + +- Connector (MCP, Streamable HTTP, no key): https://150.254.115.204/unhrdb-mcp-rpc/mcp — tools search_paragraphs, lookup_by_citation, search_recommendations, lookup_recommendation, list_uhri_facets. +- Claude plugin with the connector and four skills (un-human-rights-research, un-citation-check, treaty-body-case-law, uhri-recommendations): https://github.com/lszoszk/mcp-unhrdb#skills-for-claude. In Claude Code: `/plugin marketplace add lszoszk/mcp-unhrdb`, then `/plugin install unhrdb@mcp-unhrdb`. +- Quote the returned text verbatim and cite the UN symbol and paragraph. Searches require all bare words (use OR, "phrases" and prefix*); check that a looked-up paragraph carries the label you asked for. + ## Data and tools - [Releases and DOI (Zenodo)](https://doi.org/10.5281/zenodo.10495719) @@ -30,4 +36,5 @@ General Comments are authoritative interpretations of a treaty by its monitoring - [General Comments dataset (Hugging Face)](https://huggingface.co/datasets/lszoszk/treaty-bodies-general-comments) - [Citation graph between documents (JSON)](https://lszoszk.github.io/generalcomments/citations/graph.json) - [MCP server for AI assistants](https://github.com/lszoszk/mcp-unhrdb) +- [Claude plugin and skills](https://github.com/lszoszk/mcp-unhrdb#skills-for-claude) - [Changelog](https://lszoszk.github.io/generalcomments/changelog.html) From 82dc7dfa801c5e861cc2c6b5b08b6317a0c9422f Mon Sep 17 00:00:00 2001 From: lszoszk Date: Sat, 10 Oct 2026 20:31:35 +0200 Subject: [PATCH 2/2] docs: three UNHRDB skills; recommendation skills live with UHRI+ Co-Authored-By: Claude Opus 5.5 --- README.md | 9 +++++---- docs/index.html | 9 +++++---- docs/llms.txt | 2 +- 3 files changed, 11 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index c18d22e..3747e64 100644 --- a/README.md +++ b/README.md @@ -13,8 +13,9 @@ original document symbol and context. - **Live application:** https://lszoszk.github.io/generalcomments/ - **General Comments dataset:** https://huggingface.co/datasets/lszoszk/treaty-bodies-general-comments - **MCP integration:** https://github.com/lszoszk/mcp-unhrdb -- **Claude skills:** a plugin with the connector and four research skills — - [install](https://github.com/lszoszk/mcp-unhrdb#skills-for-claude) +- **Claude skills:** a plugin with the connector and three research skills — + [install](https://github.com/lszoszk/mcp-unhrdb#skills-for-claude); skills for + the recommendations to States come with [UHRI+](https://lszoszk.github.io/UnitedNations_recommendations/skills/README.md) - **Methodology:** [METHODOLOGY.md](METHODOLOGY.md) - **Document status audit:** [STATUS_AUDIT.md](STATUS_AUDIT.md) @@ -65,8 +66,8 @@ the data. the companion `mcp-unhrdb` server. - Ships [Claude skills](https://github.com/lszoszk/mcp-unhrdb#skills-for-claude) for researching UN human rights law with verbatim, paragraph-cited sources, - checking UN citations in a text, analysing treaty-body case law, and searching - recommendations to States. Install in Claude Code with + checking UN citations in a text and analysing treaty-body case law (skills for + recommendations to States are published with [UHRI+](https://lszoszk.github.io/UnitedNations_recommendations/skills/README.md)). Install in Claude Code with `/plugin marketplace add lszoszk/mcp-unhrdb` and `/plugin install unhrdb@mcp-unhrdb`. diff --git a/docs/index.html b/docs/index.html index bb5a5cc..2694674 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1582,7 +1582,7 @@

MCP server — query it from an AI assistant

Claude skills — UN research the careful way

- A Claude plugin bundles the connector with four skills that teach the + A Claude plugin bundles the connector with three skills that teach the assistant how to work with these sources: choose the right kind of document (interpretation, case, expert opinion, recommendation), search the way the index works, quote verbatim and pin every @@ -1590,9 +1590,10 @@

Claude skills — UN research the careful way

answers questions of UN human rights law; un-citation-check verifies the UN citations in a draft, brief or AI answer; treaty-body-case-law - reads decisions on individual complaints from their operative paragraph; - uhri-recommendations searches recommendations to - States. In Claude Code: /plugin marketplace add lszoszk/mcp-unhrdb, + reads decisions on individual complaints from their operative paragraph. + Skills for the recommendations to States are published with + UHRI+. + In Claude Code: /plugin marketplace add lszoszk/mcp-unhrdb, then /plugin install unhrdb@mcp-unhrdb. For claude.ai and other set-ups see github.com/lszoszk/mcp-unhrdb#skills-for-claude. diff --git a/docs/llms.txt b/docs/llms.txt index c3d2674..714a894 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -26,7 +26,7 @@ General Comments are authoritative interpretations of a treaty by its monitoring ## Using it from an AI assistant - Connector (MCP, Streamable HTTP, no key): https://150.254.115.204/unhrdb-mcp-rpc/mcp — tools search_paragraphs, lookup_by_citation, search_recommendations, lookup_recommendation, list_uhri_facets. -- Claude plugin with the connector and four skills (un-human-rights-research, un-citation-check, treaty-body-case-law, uhri-recommendations): https://github.com/lszoszk/mcp-unhrdb#skills-for-claude. In Claude Code: `/plugin marketplace add lszoszk/mcp-unhrdb`, then `/plugin install unhrdb@mcp-unhrdb`. +- Claude plugin with the connector and three skills (un-human-rights-research, un-citation-check, treaty-body-case-law): https://github.com/lszoszk/mcp-unhrdb#skills-for-claude. Skills for the recommendations to States (uhri-plus, uhri-plus-country-brief, uhri-plus-legal-grounding, uhri-plus-dashboard-link): https://lszoszk.github.io/UnitedNations_recommendations/skills/README.md. In Claude Code: `/plugin marketplace add lszoszk/mcp-unhrdb`, then `/plugin install unhrdb@mcp-unhrdb`. - Quote the returned text verbatim and cite the UN symbol and paragraph. Searches require all bare words (use OR, "phrases" and prefix*); check that a looked-up paragraph carries the label you asked for. ## Data and tools