agentsclimarketplace

Ship

Skill onur-gokyildiz-bhi/codescope/.claude/skills/ship

Cut a release — bump version, update CHANGELOG, tag, push, create GitHub release, install local binaries.From its SKILL.md

Install
npx -y skills add onur-gokyildiz-bhi/codescope --skill ship

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.6 KB, as published. Nobody here has run it

/ship

Full release workflow. Use when the user says "ship", "release X.Y.Z", "tag and push", or after a sprint concludes.

When to invoke

  • All P0/high-priority planned work is status:done in the knowledge graph
  • cargo clippy --workspace -- -D warnings clean
  • cargo fmt --all -- --check clean
  • cargo test --workspace green (or explicitly waived)
  • Tool count ≤ 40

Protocol

  1. Pre-flight (hand off to Ada for signoff):

    • Run clippy, fmt check, test
    • grep -c '#\[tool(' crates/mcp-server/src/tools/*.rs | awk -F: '{s+=$2}END{print s}'
    • If any check fails, stop and report
  2. Version bump:

    # Edit workspace Cargo.toml version = "X.Y.Z"
    cargo check --workspace  # updates Cargo.lock
    
  3. Commit:

    git add Cargo.toml Cargo.lock
    git commit -m "release: vX.Y.Z — <one-line summary>"
    
  4. Tag and push:

    git tag -a vX.Y.Z -m "vX.Y.Z: <summary>"
    git push origin main vX.Y.Z
    
  5. GitHub release:

    gh release create vX.Y.Z \
      --title "vX.Y.Z — <title>" \
      --notes "<markdown notes with features, fixes, breaking changes, migration>"
    
  6. Local binary install:

    taskkill /F /IM codescope.exe 2>&1 | head -2  # Windows
    # or: pkill -f codescope                       # Unix
    cargo build --release
    # Copy all 4 binaries to ~/.local/bin/
    
  7. Knowledge entry:

    knowledge(action="save",
      title="Release vX.Y.Z",
      kind="decision",
      tags=["status:done", "release", "shipped:YYYY-MM-DD", "vX.Y.Z"])
    
  8. Update planned items to done: Update knowledge entries that were status:planned and shipped in this release — replace tag with status:done + shipped:YYYY-MM-DD + vX.Y.Z.

Semver

  • patch (X.Y.Z+1): bug fix only, no new MCP tools, no tool description changes
  • minor (X.Y+1.0): new features, tool additions, backwards-compatible
  • major (X+1.0.0): breaking changes to MCP/LSP/CLI surface, tool removals or renames

Guardrails

  • Never --force on tag push
  • Never skip CHANGELOG for minor/major releases
  • Never release if cargo test --workspace fails (waive explicitly in commit message if needed)
  • Never break .mcp.json compatibility without clear migration

Codescope-first rule

  • knowledge(action="search", query="status:planned priority:high") before starting — confirm scope
  • knowledge(action="search", query="shipped:YYYY-MM-DD") after — confirm you didn't miss anything

Keep looking

Skills are one crate of 613,297. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.