Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +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 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)

Expand Down Expand Up @@ -61,6 +64,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 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`.

## Run locally

Expand Down
21 changes: 21 additions & 0 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1579,6 +1579,27 @@ <h3 class="folio">MCP server — query it from an AI assistant</h3>
</p>
</div>

<div class="about-block">
<h3 class="folio">Claude skills — UN research the careful way</h3>
<p class="serif">
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 <strong>verbatim</strong> and pin every
statement to a UN symbol and paragraph. <code class="mono">un-human-rights-research</code>
answers questions of UN human rights law;
<code class="mono">un-citation-check</code> verifies the UN citations in a
draft, brief or AI answer; <code class="mono">treaty-body-case-law</code>
reads decisions on individual complaints from their operative paragraph.
Skills for the recommendations to States are published with
<a class="about-link" href="https://lszoszk.github.io/UnitedNations_recommendations/skills/README.md" target="_blank" rel="noopener">UHRI+</a>.
In Claude Code: <code class="mono">/plugin marketplace add lszoszk/mcp-unhrdb</code>,
then <code class="mono">/plugin install unhrdb@mcp-unhrdb</code>. For claude.ai and
other set-ups see
<a class="about-link" href="https://github.com/lszoszk/mcp-unhrdb#skills-for-claude" target="_blank" rel="noopener">github.com/lszoszk/mcp-unhrdb#skills-for-claude</a>.
</p>
</div>

<div class="about-block">
<h3 class="folio">Usage statistics</h3>
<p class="serif">
Expand Down
7 changes: 7 additions & 0 deletions docs/llms.txt
Original file line number Diff line number Diff line change
Expand Up @@ -23,11 +23,18 @@ 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/<symbol>.
- 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 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

- [Releases and DOI (Zenodo)](https://doi.org/10.5281/zenodo.10495719)
- [Source code](https://github.com/lszoszk/generalcomments)
- [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)
Loading