agentleFS
wandbwandb/wandb-mcp-server/.agents/skills/release-wandb-mcp-server/SKILL.md

release-wandb-mcp-server

Skill71 starsChanged 32 days agoMITView on GitHub

Prepare, qualify, audit, or hand off a public W&B MCP Server release using the repository's machine-enforced release contract. Use for release branches, versioning, exact installed-wheel profiles, source attestations, release notes, immutable artifact evidence, readiness reviews, or rollback preparation.

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 7 are distinctive, and 5 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read RELEASING.md and the target note under docs/releases/ completely.

    line 10
  2. Distinctive:

    Run the candidate gate:

    line 13
  3. Very specific:

    Verify generated configuration/profile documentation with python scripts/public_release.py docs --check.

    line 20
  4. Very specific:

    Verify the packaged src/wandb_mcp_server/runtime-contract.json hash, then inspect the exact profile/access-mode pairs generated by python …

    line 23
  5. Very specific:

    Run the locked/latest SDK, Python, security, isolated-wheel, and installed MCP protocol gates specified by RELEASING.md.

    line 26
  6. Distinctive:

    Stop at a draft candidate unless the user explicitly authorizes the next action and repository protection allows it.

    line 28
  7. Distinctive:

    Do not continue when the controller reports a dirty tree, inconsistent version, stale SHA, unsigned or misplaced tag, missing release note, …

    line 33
  8. Very specific:

    After the approved release PR merges, source-gate must bind the merge SHA to the reviewed head tree, required current-head checks, …

    line 38
  9. Distinctive:

    If that post-merge gate or a final security check finds a source defect, stop before tagging or deployment.

    line 42
  10. Distinctive:

    Keep release notes useful to installers and contributors.

    line 60
  11. Distinctive:

    Never place credentials in arguments or evidence.

    line 74
  12. Distinctive:

    Follow the canonical release state machine.

    line 90

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Release W&B MCP Server

Follow the controller

  1. Read RELEASING.md and the target note under docs/releases/ completely.
  2. Record exact source and tree SHAs. Treat moving branches and mutable tags as navigation only, never evidence.
  3. Run the candidate gate:

    uv run --no-sync python scripts/public_release.py \
      preflight --version "$VERSION" --gate candidate

    Verify generated configuration/profile documentation with python scripts/public_release.py docs --check.

  4. Verify the packaged src/wandb_mcp_server/runtime-contract.json hash, then inspect the exact profile/access-mode pairs generated by python scripts/public_release.py profiles --all. Do not substitute counts, subsets, or copied tool lists.
  5. Run the locked/latest SDK, Python, security, isolated-wheel, and installed MCP protocol gates specified by RELEASING.md.
  6. Stop at a draft candidate unless the user explicitly authorizes the next action and repository protection allows it.

Fail closed

Do not continue when the controller reports a dirty tree, inconsistent version, stale SHA, unsigned or misplaced tag, missing release note, incomplete exact profile evidence, mutable artifact, missing scan/SBOM, or mismatched digest. Record a skipped or unavailable check as a blocker, never a pass.

After the approved release PR merges, source-gate must bind the merge SHA to the reviewed head tree, required current-head checks, approval, and resolved conversations before anyone creates the signed tag.

If that post-merge gate or a final security check finds a source defect, stop before tagging or deployment. Fix it in a new reviewed PR, treat all earlier candidate evidence as stale, and stage the repaired tree again. Never amend the already-reviewed history or reuse evidence from the superseded tree.

Build only through scripts/public_release.py build into a new directory outside the checkout. Never reuse dist/. The attest command produces a deterministic predicate for the protected signer; it is not signed evidence by itself.

Keep public release documentation factual

Track public source, W&B-hosted images, customer images, and installation qualification independently. State a channel as available only when its version note contains verified immutable evidence for that channel. Otherwise use Pending or Not recorded; never carry a digest, scan result, date, chart, or rollout claim forward from another version.

Keep release notes useful to installers and contributors. Exclude private workflow links, infrastructure identifiers, approval procedures, credentials, customer identifiers, and raw responses. After any runtime-contract or source change, regenerate the generated documentation and invalidate downstream profile or artifact evidence from the previous tree.

Preserve authorization boundaries

This skill does not authorize merging, tag creation, publication, deployment, production traffic, customer rollout, or branch-protection bypasses. Public source must merge and receive a verified signed tag before production traffic can move. Managed promotion and customer publication remain separate protected approvals.

Never place credentials in arguments or evidence. Live credentials must come from a protected process environment, and release artifacts must exclude prompts, filters, customer identifiers, raw responses, private routes, and secret names.

Hand off exact evidence

Provide the protected release controller with:

  • Version, signed tag, source SHA, and source tree SHA.
  • Packaged runtime-contract digest and exact profile/access-mode evidence digest.
  • Wheel, source distribution, checksum, SBOM, vulnerability report, signature, and provenance digests.
  • Per-channel state from the release note.
  • The previous immutable artifact and tested rollback boundary.

Follow the canonical release state machine. Any source or tree change invalidates downstream evidence and restarts qualification.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.