Skip to content

/share-page unusable from Claude Code: vercel-deploy dependency not bundled and only Pi install path documented #57

Description

@NikiforovAll

Summary

When visual-explainer is installed as a Claude Code plugin (via the visual-explainer-marketplace), /share-page fails because its hard dependency on the vercel-deploy skill cannot be satisfied: the dependency isn't bundled in the marketplace, share.sh only probes Pi-shaped paths, and the only documented install route is the pi CLI.

Repro

  1. In Claude Code, install the marketplace plugin (visual-explainer-marketplacevisual-explainer).
  2. Generate any HTML diagram.
  3. Invoke /visual-explainer:share-page <file> (or run share.sh directly).

Result:

Error: vercel-deploy skill not found
Install it with: pi install npm:vercel-deploy

The suggested install command is a Pi CLI command that Claude Code users don't have.

Root cause

Three issues compound:

  1. Not bundled. ~/.claude/plugins/marketplaces/visual-explainer-marketplace/plugins/ contains only visual-explainer/. There is no vercel-deploy/ plugin alongside it, so installing the marketplace doesn't pull in the dependency.

  2. Pi-only search paths. plugins/visual-explainer/scripts/share.sh searches only:

    for dir in ~/.pi/agent/skills/vercel-deploy/scripts /mnt/skills/user/vercel-deploy/scripts; do

    No Claude Code plugin path (e.g. ~/.claude/plugins/marketplaces/*/plugins/vercel-deploy/scripts/) is probed.

  3. Pi-only install instructions. Both SKILL.md ("Sharing Pages" section) and commands/share-page.md ("Requirements") document install only as pi install npm:vercel-deploy. There's no Claude Code equivalent anywhere in the docs.

Suggested fixes (any one would resolve)

  • Bundle vercel-deploy in the marketplace alongside visual-explainer, and add the corresponding Claude Code plugin path to share.sh's search loop.
  • Document a non-Pi install route in SKILL.md / commands/share-page.md (e.g. a git clone / manual-drop instruction for Claude Code users) — and extend share.sh to probe that location.
  • Land a variant of the previously closed PR fix(share): use Vercel CLI directly instead of deprecated vercel-deploy skill #53 that calls vercel CLI directly, eliminating the dependency entirely. (Noting this was already rejected; raising only because the underlying brokenness it cited still ships.)

Environment

  • Claude Code on Windows 11
  • visual-explainer-marketplace v0.7.1 / visual-explainer plugin v0.7.1

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions