skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
cloudcannon/agent-skills61 installs

cloudcannon-bookshop

Use when a CloudCannon site uses Bookshop — `*.bookshop.yml` files, `@bookshop/*` packages, `_bookshop_name` keys, `bookshop:live`, or `partial "bookshop"` calls or `{% bookshop %}` tags. Covers how Bookshop works, maintaining a site that stays on it, and migrating it to editable regions.

How do I install this agent skill?

npx skills add https://github.com/cloudcannon/agent-skills --skill cloudcannon-bookshop
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides comprehensive documentation and instructions for managing and migrating CloudCannon Bookshop components within various static site generator (SSG) environments. It includes guidance on configuration, troubleshooting, and best practices for moving to editable regions. All referenced resources are vendor-owned or standard developer tools, and no security risks were identified.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

CloudCannon Bookshop

Bookshop is CloudCannon's earlier component system: a component library, a build step that generates the editor's structures, and a live-editing engine that re-renders components in the Visual Editor. Editable regions replace it. This skill covers reading a Bookshop site, keeping one running, and moving it off Bookshop.

When to use

  • The site has any signal in § Detecting Bookshop
  • Adding or changing a component on a Bookshop site
  • Migrating a Bookshop site to editable regions
  • Bookshop live editing, structures or builds are misbehaving

When not to use

Detecting Bookshop

Any one signal means the site uses Bookshop.

SignalWhere
bookshop/bookshop.config.{js,cjs}src/ (Astro) or component-library/ (Hugo, Eleventy, Jekyll, Next.js)
*.bookshop.{yml,yaml,toml,json,js,cjs} beside each componentcomponent-library/components/ or src/components/
@bookshop/* packagespackage.json, in dependencies or devDependencies
npx @bookshop/generate.cloudcannon/postbuild
_bookshop_name keysFront matter, usually under content_blocks; sometimes component code too
The SSG's Bookshop plugin, module or integration, and its template callsSite config and layouts — see the SSG's bookshop.md

SSG support

Migrate when editable regions can re-render the SSG's components. Otherwise the site stays on Bookshop.

SSGBookshop enginePathDocs
Astro@bookshop/astro-engineMigrate — migrating-to-editable-regions.mdastro/overview.md
Hugo@bookshop/hugo-engineMigrate — migrating-to-editable-regions.mdhugo/overview.md
Eleventy@bookshop/eleventy-engineMigrate — migrating-to-editable-regions.mdeleventy/overview.md
Next.jsNone — @bookshop/generate writes structures onlyMigrate — migrating-to-editable-regions.mdnextjs/overview.md
Jekyll@bookshop/jekyll-engineStay on Bookshop — maintaining.md. Editable regions have no Jekyll component support yet—

Maintain or migrate?

The user wants…Do
A component added or changed, nothing moremaintaining.md — don't start a migration unasked
Off Bookshop, on an SSG marked Migratemigrating-to-editable-regions.md
Off Bookshop, on an SSG marked StayExplain it isn't possible yet; offer maintaining.md
The site moved onto CloudCannon (migrate-to-cloudcannon)Migrate, inside that journey's phases — the migration file maps the steps
UnclearAsk. A migration rewrites every component and page layout

Contents

FileCovers
SKILL.md (this file)Detection, SSG support, routing
bookshop.mdHow Bookshop works — library layout, *.bookshop.yml, @bookshop/generate, live editing, bindings
maintaining.mdChanging a site that stays on Bookshop
migrating-to-editable-regions.mdThe step order, structures from *.bookshop.yml, the _bookshop_name rename, removing Bookshop
troubleshooting.mdSymptom → cause → fix, on Bookshop sites and partway through a migration

SSG-specific:

Enter through the SSG's overview.md; it gives the reading order for that SSG's files.

SSGDocPurpose
Astroastro/overview.mdStart here for Astro
Hugohugo/overview.mdStart here for Hugo
Eleventyeleventy/overview.mdStart here for Eleventy
Next.jsnextjs/overview.mdStart here for Next.js

Other skills:

SkillWhen to read
cloudcannon-visual-editingDuring a migration — the regions, the census and the completeness checklist
cloudcannon-configurationWriting and validating the _structures that replace generated ones
cloudcannon-dev-serverLetting the user try the migrated site in a local editor

Common mistakes

ExcuseReality
"It's a Bookshop site, so I'll migrate it"Only if the user asked and the SSG is marked Migrate. A component change on a Bookshop site is a Bookshop change.
"This new component can be an editable-regions one"On a site staying on Bookshop, new components are Bookshop components — maintaining.md § Adding a component.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/cloudcannon/agent-skills/cloudcannon-bookshop">View cloudcannon-bookshop on skillZs</a>