dkyazzentwatwa/supernavigator/nav-release

Claude Code and agent skill by dkyazzentwatwa/supernavigator

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Validate and release Navigator plugin to marketplace. Auto-invoke when user says "release plugin", "publish navigator", "create release", or "deploy new version".

Install

npx vskill@latest install dkyazzentwatwa/supernavigator/nav-release

SKILL.md

Navigator Release Skill

Validate plugin integrity and release to marketplace with all safety checks.

Why This Exists

After v5.1.0 incident where nav-profile was referenced in plugin.json but never committed, causing install failures. This skill ensures:

  • All referenced skills exist and are committed
  • Version consistency across all files
  • Tag created AFTER all commits
  • Post-release verification

When to Invoke

Auto-invoke when:

  • User says "release plugin", "publish navigator"
  • User says "create release", "deploy new version"
  • User says "release vX.Y.Z"

DO NOT invoke if:

  • Just committing changes (no release)
  • Updating documentation only
  • Testing locally

Execution Steps

Step 1: Pre-Release Validation [CRITICAL]

Run validation script:

bash
python3 functions/release_validator.py --check-all

This validates:

  1. All skills in plugin.json exist
  2. All skill files are committed (not untracked)
  3. Version consistency across files
  4. No uncommitted changes in skills/

If validation fails: STOP and fix issues before proceeding.

Step 2: Display Validation Results

Show validation summary:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
NAVIGATOR RELEASE VALIDATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
Skills Check:
  [x] nav-loop          ✓ exists, committed
  [x] nav-profile       ✓ exists, committed
  [x] nav-diagnose      ✓ exists, committed
  ...
 
Version Check:
  plugin.json:      5.1.0 ✓
  marketplace.json: 5.1.0 ✓
  CLAUDE.md:        5.1.0 ✓
  README.md:        5.1.0 ✓
 
Git Status:
  Uncommitted skills: 0 ✓
  Untracked skills:   0 ✓
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VALIDATION: PASSED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Step 3: Confirm Version

Ask user to confirm version:

Ready to release Navigator vX.Y.Z
 
This will:
1. Commit any pending changes
2. Push to origin/main
3. Create git tag vX.Y.Z
4. Create GitHub release
 
Proceed? [Y/n]
Step 4: Execute Release

If confirmed, run release sequence:

bash
# 1. Commit if needed
git add .
git commit -m "chore(release): prepare vX.Y.Z" || true
 
# 2. Push to origin
git push origin main
 
# 3. Create tag (AFTER push)
git tag -a vX.Y.Z -m "Navigator vX.Y.Z: [description]"
git push origin vX.Y.Z
 
# 4. Create GitHub release
gh release create vX.Y.Z --title "Navigator vX.Y.Z" --notes-file RELEASE-NOTES-vX.Y.Z.md
Step 5: Post-Release Verification

Verify tag contains all skills:

bash
python3 functions/release_validator.py --verify-tag vX.Y.Z

Clear local cache (for testing):

bash
rm -rf ~/.claude/plugins/cache/navigator-marketplace/

Instruct user to test:

Release complete! To verify:
 
1. Run: /plugin install navigator
2. Check plugin list shows vX.Y.Z
3. Verify no errors in plugin details
 
If errors occur, see: .agent/sops/deployment/plugin-release.md

Predefined Functions

functions/release_validator.py

Validates plugin integrity before release:

bash
# Check all skills exist and are committed
python3 functions/release_validator.py --check-all
 
# Verify specific version
python3 functions/release_validator.py --check-version 5.1.0
 
# Verify tag contents
python3 functions/release_validator.py --verify-tag v5.1.0

Error Handling

Missing skill detected:

❌ VALIDATION FAILED
 
Missing skills:
  - skills/nav-profile/ (referenced in plugin.json but not found)
 
Fix: Create the skill or remove from plugin.json

Uncommitted skills detected:

❌ VALIDATION FAILED
 
Uncommitted skills:
  - skills/nav-loop/ (modified)
  - skills/nav-profile/ (untracked)
 
Fix: git add skills/ && git commit -m "Add missing skills"

Version mismatch detected:

❌ VALIDATION FAILED
 
Version mismatch:
  plugin.json:      5.1.0
  marketplace.json: 5.0.0  ← MISMATCH
  CLAUDE.md:        5.1.0
 
Fix: Update marketplace.json to 5.1.0

Success Criteria

Release is successful when:

  • [ ] All skills validated (exist + committed)
  • [ ] Version consistent across all files
  • [ ] Git tag created after all commits
  • [ ] GitHub release published
  • [ ] Test installation succeeds (no errors)

Quick Reference

bash
# Full release with validation
"Release Navigator v5.2.0"
 
# Just validate (no release)
"Validate plugin for release"
 
# Fix after failed release
"Fix release tag v5.1.0"

Related

  • SOP: .agent/sops/deployment/plugin-release.md
  • Config: .claude-plugin/plugin.json
  • Marketplace: .claude-plugin/marketplace.json

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
32
Repository forks
3
7-day trend score
17

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 14 May 2026, 5 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/dkyazzentwatwa/supernavigator/nav-release/badge)](https://verified-skill.com/skills/dkyazzentwatwa/supernavigator/nav-release)

Something wrong with this skill or its page? Tell us.