Skip to content

Commit 396cffb

Browse files
aborrusoclaude
andcommitted
docs: skill linkata e installabile nel README, link assoluti (PyPI-safe)
Sezione dedicata alla skill rndt-explorer con istruzioni di installazione in ~/.claude/skills e esempi di attivazione. Link relativi convertiti in assoluti: il README è mostrato anche su PyPI, dove i relativi si rompono. Fix link opensdmx (ondata, non aborruso). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 604fc1d commit 396cffb

1 file changed

Lines changed: 24 additions & 6 deletions

File tree

README.md

Lines changed: 24 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ pensata per essere orchestrata da un'AI.
1313

1414
**Il modo giusto di trovare dati territoriali con l'AI.** I modelli linguistici capiscono bene le domande, ma inventano nomi di dataset e URL di servizi WMS/WFS che non esistono. Il pattern corretto è usare l'AI per *comporre interrogazioni al catalogo ufficiale*, non per generare i riferimenti. openrndt è il layer di esecuzione di quel pattern: l'AI decide cosa cercare, openrndt interroga il RNDT e restituisce metadati e URL reali, verificabili.
1515

16-
> **Al meglio con un'AI.** openrndt funziona benissimo da solo, ma **dà il massimo se guidato da un agente AI**: la CLI è progettata per essere composta, interrogata e orchestrata passo passo. Per un'esperienza guidata — scoperta delle codelist, ricerca con filtri progressivi, dettaglio del metadato, risorse scaricabili — abbinala alla Agent Skill [`rndt-explorer`](skills/rndt-explorer/SKILL.md) inclusa in questo repo. I principi di design sono nella sezione [Per agenti AI](#per-agenti-ai).
16+
> **Al meglio con un'AI.** openrndt funziona benissimo da solo, ma **dà il massimo se guidato da un agente AI**: la CLI è progettata per essere composta, interrogata e orchestrata passo passo. Per un'esperienza guidata — scoperta delle codelist, ricerca con filtri progressivi, dettaglio del metadato, risorse scaricabili — abbinala alla Agent Skill [`rndt-explorer`](https://github.com/ondata/openrndt/blob/main/skills/rndt-explorer/SKILL.md) inclusa in questo repo. I principi di design sono nella sezione [Per agenti AI](#per-agenti-ai).
1717
1818
> Stato: v1.0 — read-only.
1919
@@ -292,7 +292,7 @@ set_base_url("https://mio-mirror.example.com/RNDT")
292292

293293
L'utente primario di questa CLI è un agente che legge `stdout` e compone i comandi
294294
passo passo. Da qui i principi di design (sul modello di
295-
[opensdmx](https://github.com/aborruso/opensdmx)):
295+
[opensdmx](https://github.com/ondata/opensdmx)):
296296

297297
- **Output strutturato, mai oggetti Python.** Default JSON su `stdout`; `--format
298298
table` per la lettura umana, `--format csv` per i risultati tabellari, `--format
@@ -306,15 +306,33 @@ passo passo. Da qui i principi di design (sul modello di
306306
- **Niente formati ambigui.** `get <id> --format csv` (dettaglio non tabellare)
307307
fallisce con un messaggio esplicito invece di restituire output vuoto.
308308

309-
Il progetto include inoltre una skill Claude Code in `skills/rndt-explorer/` che guida
310-
un agente attraverso le 4 fasi: scoperta delle codelist, ricerca con filtri progressivi,
311-
lettura del dettaglio, download delle risorse collegate (WMS/WFS/download).
309+
### La skill `rndt-explorer` — esplorazione guidata
310+
311+
Il repo include una **Agent Skill** per Claude Code:
312+
[`skills/rndt-explorer/`](https://github.com/ondata/openrndt/blob/main/skills/rndt-explorer/SKILL.md). Guida l'agente
313+
attraverso 4 fasi: scoperta delle codelist (offline), ricerca con filtri
314+
progressivi, lettura del dettaglio, individuazione delle risorse scaricabili
315+
(WMS, WFS, download diretto). Include workflow pronti e verificati per casi
316+
d'uso reali — dall'operatore GIS che vuole un layer per QGIS al data journalist
317+
che deve scaricare i dati, verificarne la licenza e citare la fonte.
318+
319+
**Installazione** (dopo aver installato la CLI):
320+
321+
```bash
322+
git clone https://github.com/ondata/openrndt.git
323+
mkdir -p ~/.claude/skills
324+
cp -r openrndt/skills/rndt-explorer ~/.claude/skills/
325+
```
326+
327+
Da quel momento Claude Code attiva la skill da solo quando chiedi dati
328+
territoriali italiani — «mi serve il catasto della mia zona», «trova un WMS
329+
con le ortofoto della Sardegna» — senza che tu debba nominarla.
312330

313331
## Riferimenti
314332

315333
- Pagina ufficiale REST API: <https://geodati.gov.it/geoportale/eng/strumenti-en/rest-api>
316334
- Spec completa (sito di test Esri Geoportal Server, non produzione): <https://gpt.geocloud.com/geoportal3/api/gpt_api.json>
317-
- Documentazione raccolta nella cartella [`ref/`](./ref).
335+
- Documentazione raccolta nella cartella [`ref/`](https://github.com/ondata/openrndt/tree/main/ref).
318336

319337
## Licenza
320338

0 commit comments

Comments
 (0)