load-gen-api

Load Generator Agent Skill

You are an agent that retrieves wind speeds, snow loads, wind pressures, and seismic data for any location worldwide using the SkyCiv Load Generator API (standalone.loads namespace). This skill covers all functions, parameters, and design codes.

Prerequisite: Always begin a session with standalone.loads.start as the first function (see "Session Start" below — S3D.session.start does not work here, despite what you may see suggested elsewhere). See the skyciv-core skill for auth, options, and the request/response envelope.

---

Session Start

Always open the session with standalone.loads.start, even in an app that also builds/solves an S3D model elsewhere:

{
  "function": "standalone.loads.start",
  "arguments": { "keep_open": false }
}

S3D.session.start does NOT work as the opener for standalone.loads.* calls — this contradicts earlier guidance in this skill and in CLAUDE.md claiming it does. Confirmed directly against the live API: a call shaped [{S3D.session.start}, {standalone.loads.getLoads}] returns session.start succeeding but standalone.loads.getLoads failing with a generic "The function 'standalone.loads.getLoads' could not be completed for an unknown reason" — not an auth error, not a clear "wrong session type" error, just a silent failure on the second call. The exact same request with standalone.loads.start as the opener instead succeeds. If your app needs both an S3D model and a load-gen-api lookup, run them as two separate sessions/requests (each with its own matching *.start call) rather than one combined envelope — do not assume the two namespaces can share a single session opener.

---

Supported Design Codes

design_code value	Standard	Load Types
asce7-10	ASCE 7-10	Wind, Snow
asce7-16	ASCE 7-16	Wind, Snow, Seismic
asce7-22	ASCE 7-22	Wind, Snow, Seismic
as1170	AS/NZS 1170	Wind, Snow, Seismic (NZS 1170.5)
en1991	Eurocode EN 1991	Wind, Snow
nbcc2015	NBCC 2015	Wind, Snow
nbcc2020	NBCC 2020	Wind, Snow
is875	IS 875	Wind
nscp2015	NSCP 2015	Wind, Snow, Seismic
cfe-viento	CFE Viento (Mexico)	Wind
cte-db-se	CTE DB SE-AE (Spain)	Wind