Cin7 Inventory

Cin7 Core inventory management -- products, stock, orders, purchases, customers, and suppliers via bash scripts.

Security Scan

The skill's scripts, required binaries, and environment variables match its stated Cin7 inventory-management purpose; nothing in the files indicates unrelated or hidden behavior.

Purpose & Capability

Name/description, required binaries (curl, bash), required env vars (CIN7_ACCOUNT_ID, CIN7_APP_KEY), and all script functionality consistently target the Cin7 Core API. The API headers, endpoints, and operations implemented (products, stock, orders, purchases, customers, suppliers) align with the declared purpose.

Instruction Scope

SKILL.md instructs running the included bash scripts from the skill directory; the scripts do only HTTP calls to the Cin7 API and parse command-line args. One notable behavior: scripts source a .env file (if present) and config.sh exports every key/value found, which is broader than strictly necessary if the .env contains unrelated secrets. Otherwise the instruction scope is narrow and consistent with the stated task.

Install Mechanism

This is instruction-only / script-based with no install spec and no network downloads or package installs. All code is provided in the bundle and executed with bash/curl, which is low-risk compared to remote install steps.

Credentials

The skill requires only two Cin7-related environment variables (CIN7_ACCOUNT_ID, CIN7_APP_KEY), which is proportionate. Caveat: config.sh will load and export all variables from a .env file in the skill directory (and falls back to CIN7_API_KEY), so placing other secrets in that .env could expose them to the scripts' runtime environment.

Persistence & Privilege

The skill does not request persistent/always-on privileges and does not modify other skills or system-wide agent settings. It appears to run only when invoked.

Assessment

This skill appears coherent for managing Cin7 Core via bash scripts. Before installing or running: (1) only provide the Cin7 account ID and app key — avoid putting unrelated secrets into the skill's .env because the scripts export every .env key; (2) review and, if desired, run the scripts in an isolated account or container to validate behavior; (3) confirm the API base URL matches your Cin7 instance and official docs; (4) inspect the update-order JSON construction (it injects the ID via sed) if you plan to pass complex JSON to ensure it produces valid payloads; and (5) verify you trust the skill source (homepage/owner metadata) since code runs locally.

Cin7 Inventory Management

Manage Cin7 Core inventory via bash scripts. All commands run from the skill directory.

Required Environment Variables

• CIN7_ACCOUNT_ID — your Cin7 Core account ID
• CIN7_APP_KEY — your Cin7 Core application key

Products

List/search products

bash scripts/get-products.sh
bash scripts/get-products.sh --search "widget" --page 2

Get single product

bash scripts/get-product.sh --id "product-id"

Stock

Check stock levels

bash scripts/get-stock.sh
bash scripts/get-stock.sh --product-id "product-id"
bash scripts/get-stock.sh --page 2

Adjust stock (damage, recount, write-off)

bash scripts/stock-adjustment.sh --data '{"Lines":[{"ProductID":"id","Location":"Main Warehouse","Quantity":5}]}'

Transfer stock between locations

bash scripts/stock-transfer.sh --data '{"Lines":[{"ProductID":"id","From":"Warehouse A","To":"Warehouse B","Quantity":10}]}'

Sales Orders

List orders

bash scripts/list-orders.sh
bash scripts/list-orders.sh --status "COMPLETED" --page 1

Get single order

bash scripts/get-order.sh --id "order-id"

Create order

bash scripts/create-order.sh --data '{"Customer":"John Smith","Lines":[{"ProductID":"id","Quantity":2}]}'

Update order

bash scripts/update-order.sh --id "order-id" --data '{"Status":"COMPLETED"}'

Sales report by date range

bash scripts/sales-report.sh --from "2026-01-01" --to "2026-03-07"

Purchase Orders

List purchase orders

bash scripts/get-purchases.sh
bash scripts/get-purchases.sh --status "ORDERED" --page 1

Create purchase order

bash scripts/create-purchase.sh --data '{"Supplier":"Acme Corp","Lines":[{"ProductID":"id","Quantity":100}]}'

Customers & Suppliers

List/search customers

bash scripts/get-customers.sh
bash scripts/get-customers.sh --search "John"

List/search suppliers

bash scripts/get-suppliers.sh
bash scripts/get-suppliers.sh --search "Acme"