just-ship-update

Synchronize CLAUDE.md and project.json with Just Ship framework templates without overwriting custom content.

24|5|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/yves-s/just-ship --skill just-ship-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: just-ship-update
Source: https://github.com/yves-s/just-ship/tree/main/skills/just-ship-update
Command: npx skills add https://github.com/yves-s/just-ship --skill just-ship-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It ensures your project's CLAUDE.md and project.json stay up‑to‑date with the evolving Just Ship framework, preventing missing sections or outdated references while preserving any custom content you have added.

Core Features & Use Cases

  • Template Comparison: Scans the framework's latest CLAUDE.md and project.json templates and identifies gaps in your project files.
  • Non‑Destructive Updates: Adds missing sections or fields and updates framework‑only parts without overwriting project‑specific content.
  • Automatic Invocation: Triggered by just-ship update whenever templates change, keeping your repository aligned automatically.

Quick Start

Ask the assistant to run the just‑ship‑update skill to bring your project documentation up to date.

Frequently Asked Questions about just-ship-update

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

FAQPage Schema
How do I sync project documentation with framework templates without overwriting custom content?

To sync project documentation non-destructively, the skill compares your CLAUDE.md and project.json against framework templates, adding missing sections and updating framework-only parts while preserving your custom content.

What is the best way to update CLAUDE.md files when the Just Ship framework changes?

The best way to update CLAUDE.md files is triggering the skill via `just-ship update`, which scans latest templates, parses markdown headings, and merges missing sections automatically while recording the template hash for future detection.

Does updating project.json templates overwrite my existing configuration values?

Updating project.json does not overwrite existing values. The skill merges JSON structures by adding missing fields and updating framework-only content, ensuring your project-specific configuration remains fully intact.

How does template change detection work for project documentation synchronization?

Template change detection works by reading framework template files, comparing them against your project files, and recording a template hash after merging, which allows future updates to identify when frameworks evolve.

Can I automatically keep my repository aligned with evolving framework documentation?

You can automatically keep your repository aligned by running the skill whenever templates change. It scans for gaps in your project files and applies non-destructive updates to prevent outdated references.