# urn-solid

> A curated, LLM-native registry of `urn:solid:` terms mapped to common RDF vocabularies (foaf, schema.org, dcterms, vcard, activitystreams, prov, ldp, solid). Every term is JSON-LD.

The **one-shot corpus** is the canonical artifact for any LLM or agent working with `urn:solid:` terms. Fetch it once; everything else is reference material.

## Canonical URLs

- Corpus (all terms, JSON Lines): https://urn-solid.github.io/corpus.jsonl
- Label index (fast lookup): https://urn-solid.github.io/index.json
- JSON Schema (term shape): https://urn-solid.github.io/schema/term.schema.json
- JSON-LD context: https://urn-solid.github.io/context.jsonld
- Agent skill: https://urn-solid.github.io/SKILL.md

## URL shape

Every term `urn:solid:<Name>` resolves to `https://urn-solid.github.io/<Name>/` — an HTML page with the JSON-LD inlined as a `<script type="application/ld+json">` data island. The raw JSON-LD is also available at `/<Name>/index.json`.

Classes use PascalCase (`Person`, `Agent`); properties use camelCase (`name`). Names are case-sensitive per RFC 8141.

## How to use

1. **Resolve a term**: fetch `https://urn-solid.github.io/<Name>/` (HTML with JSON-LD inlined) or `https://urn-solid.github.io/<Name>/index.json` (raw JSON-LD).
2. **Map foreign RDF to urn:solid**: for each IRI in your data, search `corpus.jsonl` for a term whose `owl:sameAs` or `rdfs:seeAlso` matches.
3. **Find unmapped terms**: IRIs that don't match anything in the corpus are candidates for new `urn:solid:` terms — open an issue at https://github.com/urn-solid/urn-solid.github.io/issues.
4. **Disambiguate**: each term lists `notToBeConfusedWith` — use it when choosing between similar terms.

## Shape of a term (abbreviated)

```json
{
  "@context": "https://urn-solid.github.io/context.jsonld",
  "@id": "urn:solid:Person",
  "@type": "rdfs:Class",
  "rdfs:label": "Person",
  "rdfs:comment": "A human being.",
  "owl:sameAs": "http://xmlns.com/foaf/0.1/Person",
  "rdfs:seeAlso": ["https://schema.org/Person"],
  "notToBeConfusedWith": ["urn:solid:Agent"],
  "status": "stable",
  "added": "2026-04-18",
  "notes": "...",
  "examples": [...],
  "provenance": {...},
  "history": [...]
}
```

Full schema: https://urn-solid.github.io/schema/term.schema.json