SkyCiv AI Skills

A library of skills — structured, LLM-readable documentation and workflows — for building structural engineering software on top of the SkyCiv API. Point any AI coding assistant or agent at this repo and it will know how to correctly model, analyze, design, visualize, and report on structures using SkyCiv’s engineering engine, instead of guessing at request shapes and units.

These skills are maintained by SkyCiv and kept in sync with the live API, so agents get correct schemas, units, and call sequences on the first try.

---

What is a “skill”?

Each folder below is a self-contained SKILL.md file (plus, where relevant, supporting assets like JSON schemas and sample inputs/outputs). A skill teaches an LLM:

• What the tool/API does and when to reach for it
• The exact request/response shape — required fields, units, defaults, gotchas
• Worked examples it can pattern-match against instead of hallucinating a payload
• Sequencing — what has to happen before what (e.g. always start a session before calling S3D.model.set)

This format is compatible with any assistant that can read markdown context — Claude Code / Claude Skills, Cursor, Windsurf, custom GPTs, or your own agent harness.

---

Getting started

1. Get a SkyCiv API key — sign up and grab one at platform.skyciv.com/api. Most skills need it; a few (run-quick-design) need an API token from the same page.
2. Clone this repo and point your assistant at the relevant SKILL.md file(s). See Using with your AI tool below for per-tool setup.
3. Always start with skyciv-api-v3 if you’re using any *-api skill — it covers auth, sessions, and the shared request/response envelope every other API skill builds on.
4. Read the API docs alongside the skill when you need more depth: skyciv.com/api/v3/docs.

Using with your AI tool

Claude Code — CLAUDE.md is auto-loaded when you open this repo. For another project, copy the relevant skill folder(s) into .claude/skills/ in that project’s root.

GitHub Copilot (VS Code) — .github/copilot-instructions.md is auto-loaded as workspace context when you open this repo. Reference individual skills in Copilot Chat with #file:path/to/SKILL.md.

Cursor — Open this repo and reference skills with @file in Cursor Chat. For persistent context across sessions, copy relevant SKILL.md content into .cursor/rules/.

Windsurf / other agents — Copy the relevant SKILL.md files into your agent’s system prompt or rules directory, or include them as file context in your session.

---

Skills included