You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
feat(skill): add AI skill section to README, security note, update .skill package
- README: new section documenting the ckan-mcp skill (purpose, examples,
install via npx skills, Claude Desktop .skill file, skills.sh link)
- SKILL.md: add Security section warning to treat external CKAN content
as untrusted (prompt injection mitigation)
- skills/claude-desktop/ckan-mcp.skill: rebuilt with all session updates
(correct europa.eu country filter, Flow A EU fallback, Flow C tool
choice, SPARQL/CKAN API docs, security note)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: README.md
+50Lines changed: 50 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -431,6 +431,56 @@ ckan_datastore_search_sql({
431
431
432
432
---
433
433
434
+
## 🧠 AI Skill for smarter multi-step queries
435
+
436
+
The MCP server provides the raw tools — the skill teaches your AI assistant **how to use them intelligently**.
437
+
438
+
Out of the box, an AI assistant knows each tool individually. The skill adds higher-level reasoning: which portal to query for a given country, what to do when a portal is unreachable, how to fall back to the European open data portal, and how to construct queries that actually return results.
439
+
440
+
**What the skill adds:**
441
+
442
+
-**Country routing** — automatically identifies the most authoritative CKAN portal for a country (national > regional > local)
443
+
-**Fallback chain** — if a portal is unreachable or returns 0 results, tries alternatives and, for European countries, falls back to `data.europa.eu` with correct country filters
-**Correct API patterns** — the European portal (`data.europa.eu`) requires specific `facets+facetOperator+facetGroupOperator` parameters that are undocumented and easy to get wrong; the skill encodes this correctly
The skill folder lives at [`skills/ckan-mcp/`](https://github.com/ondata/ckan-mcp-server/tree/main/skills/ckan-mcp) in this repository and is listed on [**skills.sh**](https://skills.sh/ondata/ckan-mcp-server). Use the [Skills CLI](https://github.com/vercel-labs/skills#readme) to install it:
469
+
470
+
```bash
471
+
# Install globally (available in all your projects)
472
+
npx skills add -g ondata/ckan-mcp-server
473
+
474
+
# Or for a single project (run from your project folder)
475
+
npx skills add ondata/ckan-mcp-server
476
+
```
477
+
478
+
### Claude Desktop — `.skill` file
479
+
480
+
For Claude Desktop, a ready-to-import `.skill` package is available at [`skills/claude-desktop/ckan-mcp.skill`](https://github.com/ondata/ckan-mcp-server/blob/main/skills/claude-desktop/ckan-mcp.skill). Download it and drag it into Claude Desktop to install directly.
0 commit comments