ce-update

Check the installed compound-engineering plugin version against upstream and recommend the update command.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Norfolk-Group/marcela-norfolk-ai --skill ce-update-norfolk-group
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ce-update
Source: https://github.com/Norfolk-Group/marcela-norfolk-ai/tree/main/skills/compound-engineering/skills/ce-update
Command: npx skills add https://github.com/Norfolk-Group/marcela-norfolk-ai --skill ce-update-norfolk-group

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Claude Code users running the compound-engineering plugin may fall behind the upstream release without noticing, leading to stale behavior or bugs already fixed on main. This Skill verifies whether the installed plugin version matches the upstream plugin.json on main and tells you exactly how to update if it does not. ## Core Features & Use Cases - Version Probing: Runs three shell scripts in parallel to fetch the upstream version from GitHub, the currently loaded version from the marketplace cache path, and the marketplace name. - Decision Logic: Compares versions and reports either an up-to-date confirmation or the exact claude plugin update command with the correct marketplace name. - Graceful Failure Handling: Detects when the GitHub CLI is unavailable or rate-limited, and when the skill is loaded outside the marketplace cache (e.g., local development with --plugin-dir), and explains what to do in each case. - Use Case: You suspect a bug in compound-engineering was fixed upstream. Ask to check the plugin version, and the Skill confirms whether you are current or gives you the one-line update command. ## Quick Start Ask Claude Code to check whether the compound-engineering plugin is up to date and update it if a newer version is available.

Frequently Asked Questions about ce-update

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if the compound-engineering plugin is up to date?

Invoke the ce-update skill in Claude Code. It runs scripts that fetch the upstream version from plugin.json on main via the GitHub CLI and compare it against the version segment in your marketplace cache path, then reports whether an update is needed.

How do I update the compound-engineering plugin in Claude Code?

Run claude plugin update compound-engineering@<marketplace-name>, then restart Claude Code to apply the update. The skill derives the correct marketplace name from your install path rather than hardcoding it, since the plugin ships under multiple marketplace names.

Why does the version check compare against main instead of release tags?

The marketplace installs plugin contents from main HEAD, not from release tags. Comparing against tags would false-positive whenever main is ahead of the last tag, which is the normal state between releases.

Does ce-update work outside Claude Code or with --plugin-dir?

No. The skill is Claude Code-only because it relies on the plugin harness cache layout under ~/.claude/plugins/cache. In --plugin-dir local development sessions it detects the non-marketplace path and tells you no action is needed for that session.

What happens if the GitHub CLI is unavailable or rate-limited?

The upstream-version script prints a sentinel value, and the skill informs you that the upstream version could not be fetched because gh may be unavailable or rate-limited, then stops without making any changes.