Agent Skills
Getting Started
Section titled “ Getting Started”Nexus SDV ships two skills for coding agents. A skill is a set of instructions an agent follows. These two describe how to install a platform and how to operate one. They are a first version and will change.
| Skill | What the agent does with it |
|---|---|
nexus-install | Checks whether a Google Cloud project can take a platform, writes the configuration, runs the bootstrap in Cloud Build and reads the result. It also tears a platform down. |
nexus-operate | Checks the health of a running platform, watches certificate expiry, sends test telemetry through the platform, reads it back through the Data API and reports which vehicles the platform knows. |
Where to find them
Section titled “Where to find them”Both skills are part of the Nexus repository, under .agents/plugins/nexus-sdv/skills/.
How to use them
Section titled “How to use them”Open the Nexus repository with your coding agent and ask it to use a skill, naming your Google Cloud project:
Use the nexus-install skill to install a Nexus SDV platform into the project <PROJECT_ID>.Your agent will ask you for what it still needs, for example the Google Cloud region Nexus SDV is to be installed in, or whether the platform gets its own domain.
If your agent does not load skills from that directory by itself, point it at the SKILL.md file of the skill.
What to know before you start
Section titled “What to know before you start”The agent will ask whether the platform is to be installed as local or remote. Our recommendation:
- Start with
localif you are new to Nexus SDV. It needs no domain and nothing arranged outside your project, and it shows the whole path from a vehicle registering to its telemetry in FleetView. - Choose
remotefor a platform that a larger group of people will use. It runs under your own domain and leverages Google Cloud CA pools.
Moving from local to remote is a new installation, not an upgrade. What the two differ in is described under Local or remote PKI.
An agent is an agent: it acts on its own, with your gcloud credentials, in the project you name. The skills tell it what to do and where to stop and ask you. They do not replace your judgment. Read what it proposes before you agree, and keep your common sense in the room.