Livestock Assistant

AI-powered livestock management assistant for Spanish-speaking farmers. Provides expert advice on herd management, animal health, reproduction, genetics, nut...

Security Scan

The skill's description (a Node.js REST API + assistant) doesn't match its packaging and requirements: it asks for multiple AI keys and to run files that are not included, which is incoherent and should be clarified before use.

Purpose & Capability

The skill claims to provide a Node.js REST API and references runtime files (scripts/start.sh, src/assistant/systemPrompt.ts), but the bundle contains no code or scripts—only docs. Requiring the node binary and installing ts-node would make sense if code were present, but as packaged the install/requirements are disproportionate to an instruction-only skill.

Instruction Scope

Runtime instructions tell the agent to start a local Express server and to load a system prompt from src/assistant/systemPrompt.ts; those files are not present in the manifest. The SKILL.md also lists reading domain reference files (which are present) — that part is fine — but the missing start script and source files are a clear mismatch.

Install Mechanism

Install spec requests the ts-node npm package (creates ts-node binary). Installing ts-node from npm is a moderate-risk action but is unnecessary here because no TypeScript code is provided. No external download URLs or extract steps are present.

Credentials

requires.env lists OPENAI_API_KEY, ANTHROPIC_API_KEY, and GOOGLE_GENERATIVE_AI_API_KEY, but SKILL.md states 'Set at least one API key' and marks OPENAI_API_KEY as primaryEnv. Requiring all three credentials is disproportionate and inconsistent with the stated 'at least one' policy. Supplying multiple model provider keys increases blast radius if the skill acts autonomously.

Persistence & Privilege

The skill does not request always:true, does not declare config paths, and is user-invocable only. Autonomous invocation is allowed by default (disable-model-invocation: false), which is normal, but combined with the multi-provider credential requirement this raises caution (see guidance).

What to consider before installing

This package appears incomplete or mispackaged. Before installing or providing API keys: 1) Confirm whether the repository actually includes the Node/Express code and the scripts referenced in SKILL.md (scripts/start.sh, src/assistant/systemPrompt.ts). 2) Don't supply all three AI provider keys unless you trust the author — provide only the single provider key you intend to use. 3) Ask the maintainer to fix the manifest so requires.env matches the documented 'at least one' requirement, or include the missing code. 4) If you plan to run the server locally, review the server code and startup script for network endpoints, data collection, and any external calls. 5) If you cannot validate the code/repository, avoid installing or granting credentials; treat this as an untrusted, incomplete skill.

OpenClaw Livestock Assistant

Expert livestock management assistant for Spanish-speaking farmers. Responds always in Spanish. Combines AI chat with a REST API for herd record-keeping.

Capabilities

• Herd management — register and track animals (bovine, ovine, caprine, porcine, equine, poultry)
• Animal health — vaccination schedules, disease identification, treatment guidance
• Reproduction — heat detection, pregnancy tracking, birth records, genetics
• Nutrition — ration formulation, forage selection, supplementation
• Breed advice — selection by aptitude (meat / milk / wool / dual-purpose)
• REST API — persistent record-keeping via Express server on http://localhost:3000

Starting the API Server

Before using any REST API endpoint, start the server:

bash scripts/start.sh

The server exposes /health, /api/animals, and /api/assistant — see references/api.md for the full endpoint reference.

AI Provider Configuration

The assistant supports OpenAI, Anthropic (Claude), and Google (Gemini). Set at least one API key; the assistant auto-selects the provider.

Provider	API key env var	Default model
OpenAI	OPENAI_API_KEY	gpt-5
Anthropic	ANTHROPIC_API_KEY	claude-opus-4-6
Google	GOOGLE_GENERATIVE_AI_API_KEY	gemini-2.5-pro

Override explicitly via:

• AI_PROVIDER=openai|anthropic|google — force a specific provider
• AI_MODEL=<model-id> — override the model ID for the chosen provider

AI Chat

Every interaction should be in Spanish. Use the system prompt embedded in src/assistant/systemPrompt.ts as the agent's knowledge baseline.

Create a session before sending messages:

curl -X POST http://localhost:3000/api/assistant/sessions
# → { "sessionId": "...", "welcome": "¡Hola! Soy el Asistente de Ganadería..." }

curl -X POST http://localhost:3000/api/assistant/sessions/<sessionId>/messages \
  -H "Content-Type: application/json" \
  -d '{"message": "¿Cómo prevenir la mastitis en vacas lecheras?"}'

Domain References

Load these files when you need detailed reference data:

Reference	When to read
references/breeds.md	User asks about breeds, selection, or characteristics
references/diseases.md	User reports symptoms, asks about prevention or treatment
references/nutrition.md	User asks about feeding, rations, forages, or supplementation
references/api.md	User wants to register animals or retrieve herd data

Animal Status Reference

Field	Allowed values
species	bovine ovine caprine porcine equine poultry
sex	male female
status	active sold dead quarantine
healthStatus	healthy sick in_treatment recovered
reproductiveStatus	open pregnant lactating in_heat served not_applicable

Safety Guidelines

• Never diagnose diseases definitively — always recommend a veterinarian for emergencies.
• Zoonotic diseases (e.g., Brucelosis) must be flagged immediately.
• Urgency levels: low → medium → high → emergency. Escalate accordingly.