vc-publish

Publishes harness improvements from a development repo to the remote kit repository with diffing, versioning, and leak detection.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/HyuseCS/project-c --skill vc-publish-hyusecs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-publish
Source: https://github.com/HyuseCS/project-c/tree/main/.claude/skills/vc-publish
Command: npx skills add https://github.com/HyuseCS/project-c --skill vc-publish-hyusecs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Maintainers of a shared harness kit need a controlled way to push improvements from their development repo to the remote kit repository without leaking project-specific content, skipping manifest reconciliation, or pushing unreviewed changes. ## Core Features & Use Cases - Resolver-driven diffing: Computes added, modified, deleted, and preserved files between the dev repo and kit repo using resolve-manifest.mjs and compute-sync-plan.mjs. - Leak detection gate: Scans the full shipped text surface for product names, absolute paths, and dangling context references before any commit, reverting on failure. - Version and release management: Bumps the manifest version (patch/minor/major), syncs the legacyDeletions ledger, commits, tags, pushes only after explicit approval, and creates a GitHub Release. - Use Case: After adding a new skill and fixing a hook in your dev repo, run the publish workflow to diff the changes, confirm a minor version bump, verify no project content leaks, and push v2.2.0 with a GitHub Release. ## Quick Start Ask the assistant to publish the current harness improvements to the kit repo and walk through the diff, version bump, and push confirmation steps.

Frequently Asked Questions about vc-publish

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

FAQPage Schema
How do I publish harness changes to the kit repo?

Create a .vc-publish-config file with the kitRepoPath pointing to your local kit checkout, then run the publish workflow. It diffs managed files, shows a summary, asks for a version bump type, runs leak detection, and pushes only after explicit approval.

What is the difference between vc-publish and vc-update?

vc-update is the user-side skill that pulls the latest harness into a project from the remote kit repo. vc-publish is the maintainer counterpart that pushes improvements from the development repo to the remote kit repo.

How does vc-publish prevent project-specific content from leaking?

It runs a resolved-set leak detection gate that greps the shipped text files for product names, absolute paths, and dangling context references. If any check fails, it prints the offending lines, reverts the kit worktree, and stops before committing.

Does vc-publish push to the remote automatically?

No. After committing and tagging locally, it stops and requires the user to explicitly type 'push' before running git push. This is a separate gate from the earlier publish confirmation, and aborting preserves the local commit and tag.

How are version bumps decided when publishing a kit release?

Patch covers hook fixes and doc updates, minor covers new skills, agents, or protocols, and major covers CLAUDE.md structure or manifest schema changes. If the kit version already matches the target, the bump is skipped and the existing version is tagged as-is.

Why must legacyDeletions be synced at every publish?

legacyDeletions is a literal path array, not a glob, so it grows each time the harness deprecates a file or directory. Skipping the dev-to-kit sync strands the kit with a stale deletion ledger, so downstream vc-update runs never clean up deprecated paths.