Structsd Install

Installs the structsd binary from source. Covers Go, Ignite CLI, and building structsd for Linux and macOS. Use when structsd is not found, when setting up a...

Security Scan

The instructions match the stated purpose (building and installing structsd) but they require running a remote install script (curl | bash) and performing privileged writes to /usr/local — review sources before running.

Purpose & Capability

The skill name/description (install structsd) aligns with the instructions: installing Go, Ignite CLI, cloning the structsd repo, and building. Nothing in the SKILL.md asks for unrelated credentials or system access beyond what an installer would need. Minor metadata mismatch: _meta.json reports version 1.0.1 while registry metadata lists 1.2.0; this is an inconsistency in packaging but not necessarily malicious.

Instruction Scope

Instructions stay within install/upgrade scope (download Go, extract to /usr/local, add ~/go/bin to PATH, install Ignite, git clone, build). They modify user shell init files and write to /usr/local, which is expected for tool installation but requires sudo/privilege. No instructions attempt to read unrelated files or export other credentials.

Install Mechanism

There is no packaged install spec (instruction-only). Downloads: Go tarballs are from the official go.dev host (expected). The Ignite install uses a curl ... | bash pattern (curl https://get.ignite.com/cli! | bash), which executes a remote script without local review — this is a high-risk installation pattern even if the site is legitimate. Building from a GitHub repo (git clone then ignite chain build) is expected. Recommend inspecting the remote install script or using a vetted package manager/release instead of piping to bash.

Credentials

The skill declares no required env vars or credentials and the instructions don't read or transmit secrets. PATH modification is appropriate for making the built binary available.

Persistence & Privilege

always:false and the skill does not request persistent platform privileges. The only persistent changes are user-level PATH edits (~/.profile or ~/.zshrc) and writing Go to /usr/local, which are normal for an installer. The skill does not modify other skills or system-wide agent config.

Assessment

This skill appears to do what it says (install structsd), but before running the instructions: 1) Inspect the remote installer script at https://get.ignite.com/cli to ensure it is trustworthy — piping curl to bash runs arbitrary code on your machine. 2) Prefer package-manager installs or verified release artifacts where possible, and verify checksums for downloaded tarballs. 3) Be aware the process uses sudo to write to /usr/local and edits your shell init files to add ~/go/bin to PATH. 4) Verify the git repository (https://github.com/playstructs/structsd) is the expected upstream. If you are unsure, run the steps in an isolated environment (container or VM) or ask for a packaged installer that does not execute unreviewed remote scripts.

Install structsd

Builds the structsd binary from source using Ignite CLI. After this procedure, structsd will be available on your PATH.

Prerequisites

Two dependencies are required: Go 1.24.1+ and Ignite CLI.

---

1. Install Go

Linux (amd64)

wget https://go.dev/dl/go1.24.1.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.1.linux-amd64.tar.gz
rm go1.24.1.linux-amd64.tar.gz

If an older Go was installed via apt, remove it first: sudo apt remove -y golang-go

macOS (Apple Silicon)

curl -OL https://go.dev/dl/go1.24.1.darwin-arm64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.1.darwin-arm64.tar.gz
rm go1.24.1.darwin-arm64.tar.gz

macOS (Intel)

curl -OL https://go.dev/dl/go1.24.1.darwin-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.1.darwin-amd64.tar.gz
rm go1.24.1.darwin-amd64.tar.gz

Alternatively on macOS: brew install go@1.24

Configure PATH

Add to ~/.profile (or ~/.zshrc on macOS):

export PATH=$PATH:/usr/local/go/bin:~/go/bin

Reload: source ~/.profile (or source ~/.zshrc)

Verify

go version

Expected: go version go1.24.1 linux/amd64 (or darwin/arm64, etc.)

---

2. Install Ignite CLI

curl https://get.ignite.com/cli! | bash

Verify

ignite version

---

3. Build structsd

Clone the repository and build:

git clone https://github.com/playstructs/structsd.git
cd structsd
ignite chain build

The binary is installed to ~/go/bin/structsd. Since ~/go/bin is on your PATH (from step 1), it's immediately available.

Verify

structsd version

---

4. Update structsd

To update to the latest version:

cd structsd
git pull origin main
ignite chain build

---

Quick Check

Run all verifications in sequence:

go version && ignite version && structsd version

If any command fails, revisit the corresponding step above.

Troubleshooting

• structsd: command not found — Ensure ~/go/bin is on your PATH. Run ls ~/go/bin/structsd to confirm the binary exists.
• ignite: command not found — Re-run the Ignite CLI install. The curl command installs to /usr/local/bin/ignite.
• go: command not found — Ensure /usr/local/go/bin is on your PATH. Reload your shell profile.
• Build fails with Go version error — Verify go version shows 1.24.1+. Older Go versions are not compatible.
• Permission denied on /usr/local — Use sudo for the tar extraction. On shared systems, ask your administrator.

See Also

• TOOLS — Environment configuration (servers, account, after structsd is installed)
• structs-onboarding skill — Player creation and first builds (requires structsd)