Skip to content

fix: stop committing dist/ zips; ship them as GitHub Release assets (v1.23.0)#38

Merged
czlonkowski merged 1 commit into
mainfrom
fix/dist-release-packaging
Jul 6, 2026
Merged

fix: stop committing dist/ zips; ship them as GitHub Release assets (v1.23.0)#38
czlonkowski merged 1 commit into
mainfrom
fix/dist-release-packaging

Conversation

@czlonkowski

Copy link
Copy Markdown
Owner

Problem

Installing the plugin via Claude Desktop / Cowork fails with Nested zip files are not allowed: "dist/n8n-agents-v1.2x.0.zip" (#31, #34). The plugin source is the repo root, and the committed dist/*.zip files get swept into the plugin bundle when the client re-zips the source. The CLI install path is unaffected (no re-zip).

Why this approach

  • The official plugin spec has no packaging-ignore or files-allowlist mechanism — the skills array in marketplace.json only controls what's scanned, not what's packaged (this repo already has one and the bug still occurs).
  • The committed zips are orphaned: README and docs/INSTALLATION.md tell Claude.ai users to zip skill folders themselves and never link the committed files.
  • Matches the community-verified fix (deleting dist/ fixes the Cowork install, per @GavinLHines).

Changes

  • Untrack all of dist/ and add it to .gitignorebuild.sh keeps working, output just stays local
  • Prebuilt zips now ship as GitHub Release assets (v1.23.0 release to follow this merge)
  • README + docs/INSTALLATION.md point at the latest release for prebuilt zips
  • Version bump 1.22.0 → 1.23.0 in build.sh, plugin.json, marketplace.json
  • CLAUDE.md updated so the convention is release-time artifacts, not committed files

Fixes #31, fixes #34

🤖 Generated with Claude Code

…v1.23.0)

Committed dist/*.zip got swept into the plugin bundle when Claude
Desktop/Cowork packaged the repo (plugin source "./"), failing installs
with 'Nested zip files are not allowed' (#31, #34). The plugin spec has
no packaging-ignore mechanism, so the zips move out of the tree: dist/
is now gitignored build output, and prebuilt zips are attached to
GitHub Releases instead. README and INSTALLATION point at the latest
release; build.sh is unchanged apart from the version bump.

(Concieved by Romuald Członkowski - www.aiadvisors.pl/en)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 6, 2026 09:27

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes Claude Desktop/Cowork plugin installation failures caused by committed dist/*.zip artifacts (nested zip rejection) by removing dist/ from version control and shifting distribution of prebuilt zips to GitHub Release assets, while updating documentation and version metadata to v1.23.0.

Changes:

  • Stop tracking dist/ artifacts by removing dist/README.md and adding dist/ to .gitignore.
  • Update installation docs to direct users to download prebuilt skill zips from the latest GitHub Release.
  • Bump version from 1.22.0 to 1.23.0 across build and plugin metadata.

Reviewed changes

Copilot reviewed 6 out of 24 changed files in this pull request and generated no comments.

Show a summary per file
File Description
README.md Updates Claude.ai install steps to reference prebuilt zips from the latest GitHub Release.
docs/INSTALLATION.md Adds guidance linking to latest release assets for prebuilt skill zips.
dist/README.md Removes committed distribution documentation (dist artifacts no longer tracked).
CLAUDE.md Documents the new convention: dist/ is local build output and release assets are used for zips.
build.sh Version bump to 1.23.0 for generated artifact naming.
.gitignore Ignores dist/ to prevent committing zip artifacts.
.claude-plugin/plugin.json Version bump to 1.23.0.
.claude-plugin/marketplace.json Version bump to 1.23.0.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@czlonkowski czlonkowski merged commit 9ea3aa5 into main Jul 6, 2026
1 check passed
@czlonkowski czlonkowski deleted the fix/dist-release-packaging branch July 6, 2026 09:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants