nav-release_skill

Overview

This skill validates Navigator plugin integrity and automates releasing the plugin to the marketplace. It runs safety checks, enforces version consistency, and performs the git and GitHub release steps only after validation passes. It is triggered by release commands like "release plugin" or "publish navigator".

How this skill works

The skill runs a pre-release validator that checks referenced skills exist, are committed, and that versions match across plugin.json, marketplace.json, and docs. After validation, it prompts for a release confirmation, performs commits and pushes, creates a git tag, and creates a GitHub release. Finally it verifies the tag contents and suggests local cache clearing and installation tests.

When to use it

• When you want to publish a new Navigator version (e.g., "release vX.Y.Z").
• When you need to ensure all referenced skills are present and committed before release.
• When you must enforce version consistency across all plugin files.
• When you are ready to create a git tag and GitHub release after final checks.
• Do not invoke for local testing, documentation-only edits, or ordinary commits.

Best practices

• Run python3 functions/release_validator.py --check-all and fix any failures before proceeding.
• Only create the git tag after all commits have been pushed to origin/main.
• Confirm the release version interactively before tagging and publishing.
• Keep release notes in RELEASE-NOTES-vX.Y.Z.md and attach them to the GitHub release.
• After release, run the post-release verifier and clear local plugin cache before testing.

Example use cases

• User says "release plugin" and the skill validates, tags v2.4.0, and creates the GitHub release.
• Run validation alone with "Validate plugin for release" to check missing or uncommitted skills.
• Recover from a failed release by fixing missing skills or version mismatches and re-running validation.
• Publish a hotfix by confirming the incremented version and letting the skill push, tag, and release.
• Verify a published tag contains all skills using python3 functions/release_validator.py --verify-tag vX.Y.Z