MOCREO API Skills

First-Time Setup

Do not proactively read or inspect the .env file. Credentials are checked automatically when the login script runs. If either v2_login.py or v3_login.py exits with code 2 and stderr contains MOCREO_CREDENTIALS_MISSING, output the following message verbatim — do not summarize, rephrase, or shorten it. Then stop and wait for the user to confirm setup is complete before taking any further action.

Credential Missing — Fixed Response

MOCREO credentials are not configured. Open a terminal, navigate to the skill folder, and run the setup script:

macOS / Linux / Windows

python scripts/setup_credentials.py

The script will guide you through platform selection and prompt for your email and password (password input is hidden). Let me know once it's done and I will continue.

If the login script does find credentials but the login still fails, do not say setup is missing. Treat that as a configured-but-invalid state: the saved account, password, or selected platform is likely wrong. In that case, tell the user that the bootstrap may have saved credentials without proving they work, ask them to rerun the setup and confirm they picked the correct platform, and only mention platform mismatch as a possibility rather than a certainty.

Do NOT run setup_credentials.py or any login script yourself. They require interactive terminal input (platform menus, hidden password) and will hang in a non-interactive AI shell.

The setup flow:

• It asks guided terminal questions to identify the user's system.
• It uses the following knowledge base:
  • MOCREO Sensor App == MOCREO Sensor System == MOCREO V2
  • MOCREO Smart App == MOCREO Smart System == MOCREO V3
  • V2 hubs: H1, H2
  • V3 hubs: H3, H5-Lite, H5-Pro, H6-Lite, H6-Pro
  • V2-only sensors: ST1, ST2, ST3, ST4, ST7, ST7-CL, SS1, NM1
  • V3-only sensors: MS2, LS1, LS2, LS3, LW1, LD1, LB1, NS1, NS2, NS3
  • Shared sensors requiring a follow-up question: ST5, ST6, ST8, ST9, ST10, MS1, SW2
• Password input is hidden via terminal secure entry and stored only in the local .env file.

Never ask the user to send their password in chat. Never guess their platform.

Routing - Which Sub-Skill to Load

Read the user's request and load the appropriate sub-skill SKILL.md:

If the system cannot be determined from the request but credentials are already configured, prefer the saved MOCREO_PLATFORM.

If the system cannot be determined and credentials are not configured yet, output the fixed "Credential Missing" response above instead of asking for free-form credential details in chat.

Once you identify the correct sub-skill, read its SKILL.md and follow the instructions there.

Before Every Shell Command

Before running any script, always output one short sentence in plain language explaining what you are about to do and why. Keep it under 15 words. Do this every time, without exception — it helps the user understand the permission prompt and feel confident approving it.

Examples:

• Logging in to get an access token.
• Fetching the list of sensors under your account.
• Checking existing API keys on Home/Asset before creating a new one.
• Deleting unused key testexamples123 from Home/Asset as confirmed.

Never use technical jargon (no "Bearer token", no "exit code", no script names) in this sentence.

Repository Layout

skills/
|- SKILL.md                       <- this file (router)
|- README.md                      <- human-facing product page
|- requirements.txt               <- shared Python dependencies
|- .env.example                   <- credential template
|- scripts/
|  |- setup_credentials.py        <- interactive shared credential setup (Python)
|- common/
|  |- mocreo_auth.py              <- shared credential and platform helpers
|- mocreo-sensor-system/
|  |- SKILL.md                    <- Sensor System instructions for AI
|  \- scripts/                   <- 11 atomic Python scripts
\- mocreo-smart-system/
   |- SKILL.md                    <- Smart System instructions for AI
   \- scripts/                   <- 15 atomic Python scripts