upgrade-testnet
Skill3 starsChanged 49 days agoMITView on GitHub
Upgrade Firedancer or Frankendancer on an operator-configured testnet instance with leader-window checks, release-matched tooling, scoped restart and voting verification.
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- doublezero-statusSkill
- inventorySkill
- jito-bam-boostSkill
- jitosol-stewardSkill
- marinade-bond-sweepSkill
- onboardingSkill
- sfdp-checkSkill
- upgrade-agave-primarySkill
- upgrade-agaveSkill
- upgrade-mainnetSkill
- validator-performanceSkill
- validator-revenueSkill
- votex-roi-simSkill
- votex-statusSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 5 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 13
Read installed bundle and configuration before running commands.
- Distinctive: line 17
Verify testnet identity, vote account, local RPC health, installed client, ledger and co-located services.
- Distinctive: line 18
Check the upcoming leader schedule with coverage sufficient for the maintenance window, before building and again immediately before …
- Distinctive: line 20
If this deployment uses Agave admin shutdown, obtain the matching Agave revision from the release notes/submodule and validate its CLI …
- Distinctive: line 21
Run the new fdctl's read-only config check.
- Distinctive: line 23
Verify supervisor persistence, running executable/version, testnet identity, catchup, vote progress and delinquency, plus health of …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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.
Files
Upgrade testnet Firedancer
Read installed bundle and configuration before running commands. Resolve paths from this loaded SKILL.md, not the session working directory.
Apply references/shared-upgrade-runbook.md. Resolve the testnet instance using operator-owned inventory; use references/inventory.md for missing host, config, binary, supervisor or identity information. Do not reuse another operator's paths, compiler choice or backup relationships.
- Verify testnet identity, vote account, local RPC health, installed client, ledger and co-located services. Record actual startup identity and authorized-voter behavior: some instances start directly staked, others require a deliberate identity transition.
- Check the upcoming leader schedule with coverage sufficient for the maintenance window, before building and again immediately before stopping. Use the shared runbook's conservative window policy. Near an epoch boundary, missing next-epoch coverage is not permission to restart.
- Preserve old executable/config and build the requested Firedancer revision and recursive submodules using its supported compiler/build targets. Use a bounded job count that does not starve the live validator. Confirm both built and intended installed executables.
- If this deployment uses Agave admin shutdown, obtain the matching Agave revision from the release notes/submodule and validate its CLI before the stop phase. Do not infer compatibility from a version suffix or reuse an arbitrary system binary.
- Run the new fdctl's read-only config check. Review necessary config changes and maintain rollback copies. Inspect init-stage failures for effects on shared hugepages/NICs; do not stop a mainnet backup to free memory without a separate approved plan.
- Recheck the maintenance window, stop only the testnet supervisor/retry loop and instance, and verify it is stopped. Perform required initialization only in this stopped phase. Install/start with the recorded config and identity policy.
- Verify supervisor persistence, running executable/version, testnet identity, catchup, vote progress and delinquency, plus health of co-located instances. If an identity promotion is needed, use the deployment's verified tower/identity procedure; do not improvise it from a different host's layout.
For failure or rollback, follow the shared runbook. Never automatically delete a ledger, replace a snapshot, restore a stale tower, or interrupt another instance. Report measured readiness and any missed leader window rather than declaring success after a fixed wait.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
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.

