gear-foundation/sails-dev-env
skills/sails-dev-env/SKILL.md
Use when a builder needs to prepare or repair a local macOS, Linux, or Windows machine for standard Gear/Vara Sails Rust development before building, testing, or running a local node. Do not use for live-network deployment, app-specific feature work, or Vara.eth/ethexe-only setup.
$ install --global
skillsauthnpx skillsauth add gear-foundation/vara-skills sails-dev-envInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 23, 2026, 2:39 AM20.7s3 files scanned
SKILL.md
- name:
- sails-dev-env
- description:
- Use when a builder needs to prepare or repair a local macOS, Linux, or Windows machine for standard Gear/Vara Sails Rust development before building, testing, or running a local node. Do not use for live-network deployment, app-specific feature work, or Vara.eth/ethexe-only setup.
Sails Dev Env
Goal
Get the machine to a verified baseline for standard Sails Rust work: rustup, Rust toolchains, Wasm targets, cargo-sails, and the latest official gear binary.
Sequence
- Detect whether the builder is on
macOS,Linux, orWindows. - If
rustupis missing, install it with the official bootstrap for that platform. - Install or update the
stableandnightlytoolchains, then addwasm32-unknown-unknownandwasm32v1-none. - Install the Sails Rust CLI with
cargo install sails-cli --locked, which providescargo-sailsand the standard greenfield bootstrap commandcargo sails new <project-name>. - Install the latest official
gearrelease binary fromhttps://get.gear.rs/(see Commands below for platform-specific download). - Verify the toolchain with
rustup show,cargo sails --version, andgear --version. - Route back into
../sails-new-app/SKILL.md,../ship-sails-app/SKILL.md,../sails-gtest/SKILL.md, or../sails-local-smoke/SKILL.mddepending on the builder's next task.
Commands
macOS or Linux
command -v rustup >/dev/null 2>&1 || curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
# After fresh install, restart the shell or source the env so cargo/rustc resolve:
. "${HOME}/.cargo/env"
rustup toolchain install stable
rustup toolchain install nightly
rustup default stable
rustup target add wasm32-unknown-unknown --toolchain stable
rustup target add wasm32-unknown-unknown --toolchain nightly
rustup target add wasm32v1-none --toolchain stable
rustup target add wasm32v1-none --toolchain nightly
cargo install sails-cli --locked
# Install gear binary from official releases (auto-detect architecture)
GEAR_VERSION="v1.10.0"
case "$(uname -s)-$(uname -m)" in
Darwin-arm64) GEAR_ARCH="aarch64-apple-darwin" ;;
Darwin-x86_64) GEAR_ARCH="x86_64-apple-darwin" ;;
Linux-x86_64) GEAR_ARCH="x86_64-unknown-linux-gnu" ;;
Linux-aarch64) GEAR_ARCH="aarch64-unknown-linux-gnu" ;;
*) echo "Unsupported platform: $(uname -s)-$(uname -m)"; exit 1 ;;
esac
mkdir -p "${HOME}/.local/bin"
curl -sSf "https://get.gear.rs/gear-${GEAR_VERSION}-${GEAR_ARCH}.tar.xz" | tar -xJ -C "${HOME}/.local/bin"
export PATH="${HOME}/.local/bin:${PATH}"
rustup show
cargo sails --version
cargo sails --help
gear --version
Windows
if (-not (Get-Command rustup -ErrorAction SilentlyContinue)) {
winget install Rustlang.Rustup
}
rustup toolchain install stable
rustup toolchain install nightly
rustup default stable
rustup target add wasm32-unknown-unknown --toolchain stable
rustup target add wasm32-unknown-unknown --toolchain nightly
rustup target add wasm32v1-none --toolchain stable
rustup target add wasm32v1-none --toolchain nightly
cargo install sails-cli --locked
# Install gear binary from official releases
$GearVersion = "v1.10.0"
$GearDest = "$env:USERPROFILE\AppData\Local\Programs\gear\bin"
New-Item -ItemType Directory -Force -Path $GearDest | Out-Null
Invoke-WebRequest -Uri "https://get.gear.rs/gear-$GearVersion-x86_64-pc-windows-msvc.zip" -OutFile "$env:TEMP\gear.zip"
Expand-Archive -Path "$env:TEMP\gear.zip" -DestinationPath $GearDest -Force
$env:PATH = "$GearDest;$env:PATH"
rustup show
cargo sails --version
cargo sails --help
gear --version
Guardrails
- Keep this skill self-contained. Do not depend on a sibling
gearcheckout or machine-local scripts outside this skill directory. Thegearbinary is downloaded directly fromhttps://get.gear.rs/official releases. Thescripts/install-gear.shandscripts/install-gear.ps1helpers in this skill directory are available as an alternative when a more flexible install is needed (e.g., custom tags or targets). - Prefer the latest official
gearrelease binary over building the node from source unless the user asks for a specific tag or source build. - Treat base package-manager bootstrap as outside scope. If host tools such as
curl,tar,xz, orwingetare missing, install them with the platform package manager, then continue. - Do not assume
Node.js,npm, orsails-cliare part of this skill. Install JS tooling separately only when the active workflow actually needs it. - Do not pin an arbitrary nightly date unless the target repository already requires one through a toolchain file or a failing build.
Related Skills
gear-foundation/sails-ethexe-implementer
development
VerifiedTrustedCommunity
Use when approved tasks require Rust code changes in a Sails ethexe workspace with the ethexe feature enabled. Do not use for standard Gear/Vara Sails apps without ethexe, or when the spec or architecture is still unsettled.
17SKILL.mdUpdated May 23, 2026
gear-foundation/sails-ethexe-architecture
development
VerifiedTrustedCommunity
Use when a builder needs to design or review architecture for a Sails ethexe app with dual-transport, payable methods, Solidity interface generation, or Ethereum-style events. Do not use for standard Gear/Vara Sails apps without ethexe.
17SKILL.mdUpdated May 23, 2026
gear-foundation/gear-builtin-actors
development
VerifiedTrustedCommunity
Use when a builder needs to design or debug calls from a standard Gear/Vara Sails program into runtime builtin actors such as BLS12-381, staking, proxy, or ETH bridge, including ActorId derivation, request encoding, reply decoding, and gas or ED budgeting. Do not use for regular program-to-program messaging, Vara.eth or ethexe-only work, non-Sails repositories, or runtime-maintenance tasks inside the Gear repo.
17SKILL.mdUpdated May 16, 2026
gear-foundation/sails-indexer
development
VerifiedTrustedCommunity
Use when a builder needs a read-side indexer and query API for a standard Gear/Vara Sails app using program events, IDL-driven decoding, projected read models, and optional on-chain query enrichment. Do not use for command-side backends, generic Node APIs, non-Sails repositories, Vara.eth or ethexe-first work.
17SKILL.mdUpdated May 13, 2026