portaljs-connect-ckan
Wire a scaffolded PortalJS portal to a CKAN backend over its API. Generates a tiny server-side fetch client (no runtime dependency) and feeds the /search catalog and /@namespace/slug showcases from CKAN instead of datasets.json
Install / Use
npx skills add datopian/portaljs --skill portaljs-connect-ckanInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of portaljs-connect-ckan
portaljs-connect-ckan scores 91/100 on our quality scale, 1067th of 4,700 Development & Engineering skills we index (top 23%).
Its SKILL.md is 5.9 KB long, well organised into 11 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 2,356 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so portaljs-connect-ckan is actively maintained.
- Our last check on 2026-10-29 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
portaljs-connect-ckan compared with similar skills
All 4 of these similar skills score higher than portaljs-connect-ckan; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| portaljs-connect-ckan (this skill)by datopian | 91 | 2.4k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install portaljs-connect-ckan?
- Run
npx skills add datopian/portaljs --skill portaljs-connect-ckan. The install tabs above show the steps for each supported agent. - Which AI agents does portaljs-connect-ckan work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is portaljs-connect-ckan safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is portaljs-connect-ckan still maintained?
- The repository was last updated about 2 months ago, so portaljs-connect-ckan is actively maintained.
Skill content
View source on GitHubname: portaljs-connect-ckan description: Wire a scaffolded PortalJS portal to a CKAN backend over its API. Generates a tiny server-side fetch client (no runtime dependency) and feeds the /search catalog and /@namespace/slug showcases from CKAN instead of datasets.json. Use when connecting an existing portal to a live CKAN instance instead of a static manifest. allowed-tools: Read, Write, Edit, Bash(npm:), Bash(npx:), WebFetch version: 1.0.0 author: Datopian hello@datopian.com license: MIT compatibility: Claude Code with PortalJS portals (Next.js 14, React 18, Node 18+). Runs from any project via the plugin, a personal ~/.claude/commands install, or a portaljs clone. tags:
- portaljs
- data-portal
- ckan
- backend
- api
- catalog
PortalJS — Connect CKAN
Overview
Connect an existing portaljs-catalog portal to a live CKAN backend for the "decoupled /
any backend" path. The portal stops reading the static datasets.json manifest (and files
in /public/data/) and instead feeds its two data surfaces — the /search catalog and
the /@namespace/slug showcases — straight from a CKAN instance's REST API
(package_search / package_show) through a generated fetch client. Output is plain,
editable Next.js code with no runtime dependency — never @portaljs/ckan, whose bundle
wires React UI components to React 18 internals and crashes at import under the template's
React 19. Pages fetch CKAN server-side in getStaticProps/getStaticPaths, so the catalog
is pre-rendered at build time and the site can still be statically deployed. Run this right
after portaljs-new-portal to swap a freshly scaffolded portal's sample data over to CKAN.
Prerequisites
- A scaffolded PortalJS portal (see
portaljs-new-portal) withpackage.json,pages/,datasets.json,pages/search.tsx, andpages/[owner]/[slug].tsxpresent. - A CKAN base URL that is publicly reachable, e.g.
https://demo.dev.datopian.com. - Node 18+ and npm available in the portal directory (no new packages are installed).
Instructions
The canonical, full step-by-step workflow is
.claude/commands/portaljs-connect-ckan.md —
the single source of truth. Read and follow it when executing. Summary:
- Gather input from
$ARGUMENTS— CKAN base URL (required), org filter (optional), group filter (optional), portal directory (default.). If the URL is missing, interview the user; never dead-end with a missing-input error. - Validate the target directory is a
portaljs-catalogportal; if not, suggestportaljs-new-portalinstead of failing silently. - Verify the CKAN backend is reachable via
package_search?rows=1, and validate each org filter viaorganization_show; on failure, explain and re-prompt rather than dead-ending. - Generate
lib/ckan.ts— a self-contained server-side fetch client wrappingpackage_searchandpackage_show, withDMS,ORG_FILTER,GROUP_FILTER, andMAX_DATASETSas editable constants. - Rewire
pages/search.tsxto list datasets frompackage_search, linking each to/@namespace/slugviadatasetHref; leavepages/index.tsxuntouched. - Overwrite
pages/[owner]/[slug].tsxto pre-render one page per dataset viagetStaticPathsand fetch details withpackage_show, previewing tabular resources through the existingTablecomponent. - Verify the build with
npx next build; fix any error before reporting success. - Report what changed: client, catalog, showcase, filters, and static page count.
Output
- Created:
lib/ckan.ts(fetch wrapper client — no dependency added topackage.json). - Modified:
pages/search.tsx(catalog readspackage_search);pages/[owner]/[slug].tsx(showcase readspackage_show, overwritten to drop thedatasets.jsonsource). - Unchanged:
pages/index.tsx(still the static search-first landing page). - Verified:
npx next buildsucceeds and prints the static page count. - Result:
/searchand/@namespace/slugare served from the CKAN backend; theDMSenv var can override the base URL at deploy time without editing code.
Error Handling
| Symptom | Cause | Fix |
| --- | --- | --- |
| Missing CKAN URL | User invoked the skill with no $ARGUMENTS | Ask for the base URL (and optional org/group filter); never error out. |
| package_search request fails or times out | URL isn't a reachable CKAN root | Tell the user, ask them to confirm the URL, and retry. |
| Org filter not found | organization_show returns success: false | List valid orgs from organization_list and ask which one was meant. |
| Catalog renders empty after connecting | Wrong org/group filter name in lib/ckan.ts | Clear or correct the filter constants and rebuild. |
| next build fails | Typo in substituted CKAN_URL or bad TypeScript edit | Print the log, fix the first error, and re-run before reporting success. |
| <Table> fails to load a resource | CKAN resource host blocks CORS | Note that the Download link still works; prefer datastore-backed resources. |
Examples
Example 1 — Public CKAN demo, no filters
/portaljs-connect-ckan url=https://demo.dev.datopian.com
Example 2 — Restrict the catalog to one organization
/portaljs-connect-ckan url=https://demo.dev.datopian.com org=my-org
Example 3 — Filter by group and target a specific portal directory
/portaljs-connect-ckan url=https://data.example.gov group=education dir=./my-portal
Resources
- Full workflow:
.claude/commands/portaljs-connect-ckan.md - Client, filters, and troubleshooting reference:
references/reference.md - Related skills:
portaljs-new-portal,portaljs-add-dataset,portaljs-deploy - CKAN Action API documentation: https://docs.ckan.org/en/latest/api/
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
