Communitygithub.com

modbender/skill-library-mcp

Consulta propiedades de tierra, arrendamientos, información de propietarios y pagos de tierras. Operaciones de escritura para gestión de pagos y renovaciones de arrendamientos.

¿Qué es skill-library-mcp?

Esta habilidad para agentes de IA (como Claude Code, Cursor, Codex, etc.) proporciona una interfaz completa para gestionar un portafolio de tierras agrícolas en FarmOS (versión MCP). Permite consultar y operar sobre parcelas (propias y arrendadas), arrendamientos (condiciones, fechas de vencimiento, rentas), relaciones con propietarios y pagos de tierras (rentas, hipotecas, impuestos, seguros, mejoras). Soporta operaciones de solo lectura (listar pagos, arrendamientos, propietarios, costos anuales) y operaciones de escritura autenticadas (marcar pagos como realizados, previsualizar y ejecutar renovaciones masivas de arrendamientos, y realizar rollovers de fin de año). La habilidad impone reglas críticas de integridad de datos: nunca debe usar endpoints que trunquen resultados (como el dashboard), siempre debe usar los endpoints `/all` para datos completos y reportar errores o datos incompletos al usuario. Se integra con una API base en `http://100.102.77.110:8009`, sin autenticación para lecturas y con autenticación JWT (token de 15 minutos) para escrituras. El control de acceso verifica roles en `~/.openclaw/farmos-users.json`, restringiendo datos sensibles (términos de arrendamiento, montos de renta, información de propietarios) a roles admin o manager. Los disparadores incluyen preguntas como '¿Cuándo vencen nuestros arrendamientos?', '¿Cuál es la renta del terreno Smith?', 'Mostrar pagos vencidos' o 'Marcar pagos de marzo como pagados'.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/modbender/skill-library-mcp/tree/HEAD/data/farmos-land-portfolio

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Portafolio de Tierras FarmOS

Realiza un seguimiento de tierras propias y arrendadas, términos de arrendamiento, relaciones con propietarios, pagos y costos anuales de la tierra.

CRÍTICO: Reglas de Integridad de Datos

NUNCA uses datos parciales o truncados. Estas reglas no son negociables:

  1. NUNCA uses /api/integration/dashboard — trunca los resultados a 5 elementos. Los datos de pago parciales son peores que no tener datos porque crean una falsa sensación de integridad.
  2. SIEMPRE usa los endpoints /all listados a continuación para obtener datos completos.
  3. Si un endpoint devuelve un error o resultados vacíos, REPORTA EL FALLO al usuario. No recurras silenciosamente a un endpoint diferente ni presentes datos parciales.
  4. SIEMPRE indica el recuento total de registros devueltos para que el usuario sepa que los datos están completos. Ejemplo: "Se encontraron 11 pagos con vencimiento en marzo por un total de $175,058."
  5. Si no puedes obtener datos completos, dilo explícitamente. "No pude recuperar los datos de pago completos" es infinitamente mejor que mostrar 5 de 11 pagos.

Cuándo se Activa Esta Habilidad

  • "¿Cuándo vencen nuestros arrendamientos?"
  • "¿Cuál es la renta del terreno Smith?"
  • "¿Costos totales de tierra este año?"
  • "Mostrar pagos vencidos"
  • "Información de contacto del propietario"
  • "Costo por acre por parcela"
  • "Listar todas las parcelas arrendadas"
  • "¿Qué pagos vencen en marzo?"
  • "Requerimientos de efectivo para el próximo mes"
  • "Marcar pago [X] como pagado"
  • "Marcar todos los pagos de marzo como pagados"
  • "Renovar el arrendamiento de Smith"
  • "Previsualizar renovaciones de arrendamientos"

Control de Acceso

Los términos de arrendamiento, montos de renta e información del propietario son datos comerciales sensibles. Restringir solo a roles de administrador o gerente.

Mapeo de roles: Verifica el rol del remitente en ~/.openclaw/farmos-users.json. Si el usuario no es administrador o gerente, indícale que no tiene acceso a los datos del portafolio de tierras.

Base de la API

http://100.102.77.110:8009

Endpoints de Integración (Sin Autenticación Requerida) — SOLO OPERACIONES DE LECTURA

IMPORTANTE: Usa endpoints autenticados para operaciones de ESCRITURA (marcar como pagado, renovaciones). Usa endpoints de integración /all para operaciones de LECTURA (listar pagos, arrendamientos, propietarios).

Pagos (COMPLETO — usa esto, no el dashboard)

GET /api/integration/payments/all

  • Devuelve TODOS los pagos con detalles completos: nombres de parcelas, nombres de propietarios, estado de vencimiento
  • Parámetros de consulta:
    • status — pending, paid, overdue, scheduled
    • payment_type — rent, mortgage, property_tax, insurance, improvement, other
    • parcel_id — filtrar por parcela específica
    • due_date_from — inicio del rango YYYY-MM-DD
    • due_date_to — fin del rango YYYY-MM-DD
    • crop_year — filtrar por año agrícola
  • Ejemplos:
    • Todos los vencidos: /api/integration/payments/all?status=overdue
    • Pagos de marzo 2026: /api/integration/payments/all?due_date_from=2026-03-01&due_date_to=2026-03-31
    • Todos los pagos de renta: /api/integration/payments/all?payment_type=rent

Próximos Pagos (próximos N días)

GET /api/integration/payments/upcoming?days=30

  • Devuelve TODOS los pagos próximos dentro de N días (sin truncamiento)
  • Usa days=60 o days=90 para una vista anticipada más larga

Arrendamientos (COMPLETO)

GET /api/integration/leases/all

  • Devuelve TODOS los arrendamientos con información de contacto del propietario, términos de renta, estado de vencimiento
  • Parámetros de consulta:
    • status — active, expired
    • landlord_id — filtrar por propietario

Arrendamientos por Vencer

GET /api/integration/leases/expiring?days=90

  • Devuelve TODOS los arrendamientos que vencen dentro de N días

Propietarios (COMPLETO)

GET /api/integration/landlords/all

  • Devuelve TODOS los propietarios con información de contacto, recuento de arrendamientos activos, acres totales, renta total

Parcelas

GET /api/integration/parcels

  • Devuelve TODAS las parcelas con tipo de propiedad, acres, condado
  • Parámetro de consulta: ownership_type — owned, leased

Estadísticas Resumidas

GET /api/integration/summary

  • Acres totales, desglose propio/arrendado, recuentos de parcelas/arrendamientos/propietarios, costo anual

Costos Anuales de Tierra (por mes y entidad)

GET /api/integration/finance/costs?year=2026

  • Desglose mensual de costos por categoría (renta, hipoteca, impuesto, seguro)
  • Desglose por entidad
  • Parámetros de consulta: year, entity_id

Costo por Campo (para PyG)

GET /api/integration/finance/cost-per-field?year=2026

  • Costos de tierra asignados a campos de producción
  • Parámetros de consulta: year, entity_id

Elementos Vencidos

GET /api/integration/tasks/overdue

  • Todos los pagos y recordatorios vencidos — elementos de alta prioridad

Elementos Accionables

GET /api/integration/tasks/actionable?days_ahead=30

  • Próximos pagos, arrendamientos por vencer, recordatorios pendientes

Endpoints Autenticados — OPERACIONES DE ESCRITURA

Estos requieren autenticación JWT. Consulta la sección de Autenticación a continuación.

Autenticación

Esta habilidad accede a endpoints protegidos de FarmOS que requieren un token JWT.

Para obtener un token: Ejecuta el asistente de autenticación con el rol apropiado:

TOKEN=$(~/clawd/scripts/farmos-auth.sh admin)

Para usar el token: Inclúyelo como token Bearer:

curl -H "Authorization: Bearer $TOKEN" http://100.102.77.110:8009/api/endpoint

Caducidad del token: Los tokens duran 15 minutos. Si obtienes una respuesta 401, solicita un nuevo token.

Marcar un Pago Individual como Pagado

POST /api/payments/{id}/mark-paid Authorization: Bearer {token} Content-Type: application/json

Cuerpo:

{
  "paid_date": "2026-02-15",
  "notes": "Cheque #1234"
}

Marcar Múltiples Pagos como Pagados (Masivo)

POST /api/payments/bulk/mark-paid Authorization: Bearer {token} Content-Type: application/json

Cuerpo:

{
  "payment_ids": [12, 34, 56],
  "paid_date": "2026-02-15",
  "notes": "Ejecución de cheques por lote"
}

Marcar Pagos como Pagados por Rango de Fechas

POST /api/payments/bulk/mark-paid-by-date Authorization: Bearer {token} Content-Type: application/json

Cuerpo:

{
  "due_date_from": "2026-03-01",
  "due_date_to": "2026-03-31",
  "paid_date": "2026-02-15",
  "payment_type": "rent",
  "notes": "Pagos de renta de marzo"
}

Usa esto cuando el usuario diga "marcar todos los pagos de marzo como pagados" u operaciones masivas similares basadas en fechas.

Previsualizar Renovación de Arrendamiento

POST /api/leases/renewal-preview Authorization: Bearer {token} Content-Type: application/json

Cuerpo:

{
  "lease_ids": [5, 12],
  "new_start_date": "2027-03-01",
  "rent_increase_percent": 3.0
}

Devuelve: Vista previa de cómo se verían los arrendamientos renovados, incluidos los nuevos calendarios de pago. Usa esto ANTES de ejecutar renovaciones masivas para que el usuario pueda confirmar.

Ejecutar Renovación Masiva de Arrendamientos

POST /api/leases/bulk-renew Authorization: Bearer {token} Content-Type: application/json

Cuerpo:

{
  "lease_ids": [5, 12],
  "new_start_date": "2027-03-01",
  "new_end_date": "2028-02-28",
  "new_rent_amount": 52000.00,
  "rent_increase_percent": 3.0,
  "notes": "Renovación anual con aumento del 3%"
}

IMPORTANTE: Siempre previsualiza primero, confirma con el usuario y luego ejecuta.

Previsualización de Rollover de Fin de Año

POST /api/payments/year-end-rollover/preview Authorization: Bearer {token} Content-Type: application/json

Cuerpo:

{
  "from_year": 2026,
  "to_year": 2027
}

Devuelve: Vista previa de los calendarios de pago que se crearían para el nuevo año agrícola.

Ejecutar Rollover de Fin de Año

POST /api/payments/year-end-rollover/execute Authorization: Bearer {token} Content-Type: application/json

Cuerpo:

{
  "from_year": 2026,
  "to_year": 2027,
  "apply_rent_increase": true,
  "rent_increase_percent": 2.5
}

IMPORTANTE: Esto crea los calendarios de pago del próximo año basados en los arrendamientos del año actual. Siempre previsualiza primero.

Endpoints PROHIBIDOS — No Usar

EndpointPor qué
GET /api/integration/dashboardTrunca a 5 elementos. NUNCA uses esto.

Conceptos Clave

  • Parcela: Una unidad de tierra, propia o arrendada.
  • Tipos de arrendamiento: Renta en efectivo, participación en cosecha, renta flexible.
  • Vencimiento del arrendamiento: Crítico de rastrear: las expiraciones próximas necesitan atención proactiva.
  • Pagos de tierra: Renta, hipoteca, impuesto a la propiedad, seguro, cada uno con fechas de vencimiento.

Notas de Uso

  • El seguimiento de vencimientos de arrendamientos es la consulta de mayor valor: siempre señala los arrendamientos que vencen dentro de los próximos 6 meses.
  • El estado del pago (pendiente/vencido) es crítico: señala los pagos vencidos inmediatamente.
  • El análisis de costo por acre ayuda a comparar la economía de tierras propias vs. arrendadas.
  • La información de contacto del propietario es privada: nunca la compartas fuera de los canales de administración/gerencia.
  • Cuando te pregunten sobre "requerimientos de efectivo" o "qué debemos", usa siempre /api/integration/payments/all con filtrado de fechas para obtener la imagen COMPLETA.
  • Para preguntas de planificación financiera, combina /api/integration/payments/all con /api/integration/finance/costs para una vista completa.
  • Operaciones de escritura: Siempre usa endpoints autenticados para marcar pagos como pagados o renovar arrendamientos. Previsualiza primero cuando se trate de operaciones masivas.
  • Marcado masivo de pagos: Cuando el usuario diga "marcar todos los pagos de marzo como pagados", usa el endpoint masivo por fecha en lugar de llamadas individuales.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

modbender/skill-library-mcp

Paid acquisition strategy, budget allocation, and avoiding common advertising mistakes across platforms

modbender/skill-library-mcp

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all wit...

modbender/skill-library-mcp

Borrow from Aave via credit delegation. Agent self-funds by borrowing against delegator collateral. Supports borrow, repay, health checks. Works on Aave V2/V3.

modbender/skill-library-mcp

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

modbender/skill-library-mcp

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, explainer videos, virtual influencers, dubbing, marketing videos. Triggers: ai avatar, talking head, lipsync, avatar video, virtual presenter, ai spokesperson, audio driven video, heygen alternative, synthesia alternative, talking avatar, lip sync, video avatar, ai presenter, digital human

modbender/skill-library-mcp

AI代码编辑器规则模板集合 - 为Cursor、Windsurf、Claude Code、Cline等AI编辑器提供项目规则配置。适用于需要配置AI编码助手规则的开发者,包含全栈Web、移动端、Vue3+SpringBoot等技术栈模板。

modbender/skill-library-mcp

Generate landing page code from product descriptions

modbender/skill-library-mcp

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awareness. Triggers: marketing video, ad video, promo video, commercial, brand video, product video, explainer video, ad creative, video ad, facebook ad video, youtube ad, instagram ad, tiktok ad, promotional video, launch video

modbender/skill-library-mcp

Generate AI music videos end-to-end. Creates music with Suno (sunoapi.org), generates visuals with OpenAI/Seedream/Google/Seedance, and assembles into music video with ffmpeg. Supports timestamped lyrics (auto SRT), Suno native music video generation, slideshow/video/hybrid modes. Token-based cost tracking per generation.

modbender/skill-library-mcp

Generate AI-powered notes from videos (document, outline, or graphic-text formats)

modbender/skill-library-mcp

The video AI notes tool is provided by Baidu. Based on the video download address provided by the user, it downloads and parses the video, and finally generates AI notes corresponding to the video (a total of three types of notes can be generated: document notes, outline notes, and image-text notes).

modbender/skill-library-mcp

Automated appointment management for beauty salons, clinics, studios, and photo booths. Handles booking requests, calendar sync, conflict detection, reminders, no-show tracking, and waitlist management.

modbender/skill-library-mcp

Bird identification, life list tracking, and trading card generation. Use this skill when the user: sends a bird photo to identify, says "set up my Birdfolio" or "set my region", asks "how's my checklist", asks "Birdfolio progress", asks "how many birds have I found", asks "show my Birdfolio" or "show my life list", asks "what's my rarest bird", or asks "tell me about [bird species]". Handles everything from first-time setup through ongoing life list tracking and visual trading card generation.

modbender/skill-library-mcp

Multi-project task and research management (JSON-first CLI)

modbender/skill-library-mcp

Track stock and crypto portfolios with CLI - real-time prices, P&L, dividend tracking, multiple portfolios

modbender/skill-library-mcp

Track cryptocurrency portfolios with real-time prices, P&L calculations, and allocation analysis. Query Bitcoin, Ethereum, Solana and 10,000+ token holdings.

modbender/skill-library-mcp

加密貨幣Portfolio追蹤 - 支援TRON/ETH/BSC,分析持倉、收益、Gas費用

modbender/skill-library-mcp

Lead strategy with competitive analysis, strategic planning, growth roadmaps, and business portfolio management.

modbender/skill-library-mcp

Create ATS-optimized resumes and CVs with proper structure, metrics, and industry targeting.

modbender/skill-library-mcp

Native video analysis using Google Gemini API. Upload and analyze video files — describe scenes, extract text/UI, answer questions about content, transcribe speech, identify objects and actions. Use when: (1) User sends a video file and wants it analyzed, (2) Video summarization or description needed, (3) Extracting text, UI elements, or information from screen recordings, (4) Answering questions about video content, (5) Comparing multiple videos, (6) Analyzing tutorials, demos, or walkthroughs.

Skills relacionados