Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Automatiza la gestión de inquilinos y operaciones de arrendamiento con AppFolio.

¿Qué es tons-of-skills-marketplace?

Esta habilidad automatiza el ciclo de vida completo de las órdenes de trabajo de mantenimiento a través de la API Stack de AppFolio. Es útil para administradores de propiedades y equipos de operaciones que necesitan gestionar solicitudes de mantenimiento de inquilinos, asignar proveedores a órdenes de trabajo abiertas, rastrear el progreso de las reparaciones en múltiples propiedades y cerrar trabajos completados con registros de costos. Funciona como un flujo de trabajo secundario, complementando los paneles de propiedades y las operaciones de arrendamiento. Los pasos clave incluyen la creación de una orden de trabajo a partir de una solicitud de mantenimiento, la asignación de un proveedor con una ventana de servicio programada, el seguimiento del estado de la orden y el cierre con un registro de costos detallado y notas de resolución. La habilidad incluye manejo de errores para problemas comunes como credenciales no autorizadas, órdenes no encontradas, conflictos de estado y límites de tasa, lo que garantiza una integración robusta.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/plugins/saas-packs/appfolio-pack/skills/appfolio-core-workflow-b

Preguntar en tu IA favorita

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

Documentación

AppFolio — Órdenes de Trabajo y Mantenimiento

Resumen

Gestiona el ciclo de vida completo de las órdenes de trabajo de mantenimiento a través de la API Stack de AppFolio. Utilice este flujo de trabajo cuando los inquilinos envíen solicitudes de mantenimiento, cuando necesite asignar proveedores a órdenes de trabajo abiertas, rastrear el progreso de las reparaciones en todas las propiedades o cerrar trabajos completados con registros de costos. Este es el flujo de trabajo secundario — para paneles de propiedades y arrendamientos, consulte appfolio-core-workflow-a.

Requisitos previos

  • Un contrato de AppFolio verificado y un portafolio sandbox con registros sintéticos de propiedad, unidad, proveedor y orden de trabajo; no pruebe la automatización de mantenimiento contra una unidad de producción ocupada.
  • Una identidad de servicio con privilegios mínimos, soporte de idempotencia para acciones de creación/cierre, y una ruta de escalación aprobada para mantenimiento crítico de seguridad.
  • Una política de minimización de datos: almacene y transmita solo los hechos de mantenimiento necesarios para realizar el trabajo, nunca preferencias de inquilinos, códigos de acceso o información detallada de ocupación en notas o registros genéricos de proveedores.

Instrucciones

Paso 1: Crear una Orden de Trabajo a partir de una Solicitud de Mantenimiento

const workOrder = await client.workOrders.create({
  property_id: 'prop_4821',
  unit_id: 'unit_12B',
  category: 'plumbing',
  priority: 'high',
  description: 'Synthetic plumbing fixture leak reported in sandbox unit',
  requested_by: 'tenant_8934',
  due_date: '2026-04-10',
});
console.log(`Work order ${workOrder.id} created — status: ${workOrder.status}`);

Paso 2: Asignar un Proveedor

const assignment = await client.workOrders.assign(workOrder.id, {
  vendor_id: 'vendor_plumb_01',
  scheduled_date: '2026-04-08',
  time_window: '09:00-12:00',
  notes: 'Confirm scheduled appointment through the approved work-order channel.',
});
console.log(`Assigned to ${assignment.vendor_name} on ${assignment.scheduled_date}`);

Paso 3: Rastrear el Estado de la Orden de Trabajo

const open = await client.workOrders.list({
  property_id: 'prop_4821',
  status: ['open', 'in_progress', 'scheduled'],
  sort: 'priority_desc',
});
open.items.forEach(wo =>
  console.log(`#${wo.id} [${wo.priority}] ${wo.category} — ${wo.status} (due ${wo.due_date})`)
);

Paso 4: Cerrar la Orden de Trabajo con Registro de Costos

const closed = await client.workOrders.close(workOrder.id, {
  resolution: 'Replaced P-trap and tightened supply line. No further leaks.',
  labor_cost: 175.00,
  materials_cost: 42.50,
  completed_date: '2026-04-08',
  attachments: ['receipt_plumb_0408.pdf'],
});
console.log(`Closed #${closed.id} — total cost: $${closed.total_cost}`);

Manejo de Errores

ProblemaCausaSolución
401 UnauthorizedCredenciales de API caducadas o inválidasActualice client_id/secret en el panel de Stack
404 Work Order Not FoundID de orden de trabajo incorrecto o ya eliminadoVerifique el ID con workOrders.list()
422 Missing required fieldsCategoría o property_id omitidosIncluya todos los campos requeridos según el esquema
409 ConflictLa orden de trabajo ya está cerradaVerifique el estado antes de intentar cerrar
429 Rate LimitedSuperó las 120 solicitudes/minutoAgregue retroceso exponencial con un retraso base de 1s

Salida

Una ejecución exitosa crea una orden de trabajo, la asigna a un proveedor con una ventana de servicio programada y la cierra con registros de costos y notas de resolución. El administrador de la propiedad obtiene un registro de auditoría completo desde la solicitud hasta la finalización.

Ejemplos

Para un flujo de trabajo de plomería sandbox, cree una orden de trabajo sintética con una clave de idempotencia estable, asigne un proveedor sandbox y lea su estado antes de cualquier transición. Adjunte solo un recibo de prueba no sensible, luego cierre la orden una vez y verifique el total y el registro de auditoría sin registrar detalles del inquilino o de acceso. Repita la misma solicitud para demostrar que se rechazan las órdenes de trabajo duplicadas y los registros de costos duplicados. Si la asignación del proveedor, la clasificación de seguridad, el estado anterior o el resultado del cierre es incierto, deje la orden abierta y enrútela al operador de la propiedad autorizado para su revisión.

Recursos

Próximos Pasos

Consulte appfolio-sdk-patterns para la configuración de autenticación y los ayudantes de paginación.

Individual skills in this repo

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

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page for positioning, plan a conversion-optimized page layout, or design a launch page. Examples: "landing page for product launch", "conversion-optimized layout for SaaS

jeremylongshore/tons-of-skills-marketplace

Use when asked to design growth-optimized landing pages, activation funnel layouts, or experiment-friendly page structures. Examples: "growth-optimized landing", "activation funnel layout", "A/B testable page

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page, design page layout for conversion, or plan landing page information architecture. Examples: "landing page structure for SaaS", "conversion-optimized layout

jeremylongshore/tons-of-skills-marketplace

Generate polished demo videos from a single prompt. Use when the user asks to create a demo video, product walkthrough, feature showcase, or animated presentation. Trigger with "make a demo video", "create a product video", "demo walkthrough", or "feature showcase video".

jeremylongshore/tons-of-skills-marketplace

Track cryptocurrency portfolio with real-time valuations, allocation analysis, and P&L tracking. Use when checking portfolio value, viewing holdings breakdown, analyzing allocations, or exporting portfolio data. Trigger with phrases like "show my portfolio", "check crypto holdings", "portfolio allocation", "track my crypto", or "export portfolio".

jeremylongshore/tons-of-skills-marketplace

Runs the full release workflow for the current project. Commits any uncommitted changes, pushes to remote, creates and merges a PR if on a feature branch, determines the next semver version from conventional commits, creates an annotated git tag and GitHub release with generated notes, cleans up merged branches, and returns to a clean main. Use when the user says promote, ship, release, commit and push, tag and release, or get back to main.

jeremylongshore/tons-of-skills-marketplace

Agent skill at plugins/productivity/content-multiplier/skills/channel-formats/SKILL.md

jeremylongshore/tons-of-skills-marketplace

Operate an evidence-backed editorial queue, balance topic and format coverage, schedule approved drafts, and reconcile backlog state with the publishing system. Use when choosing or scheduling the next blog work. Trigger with "show the editorial calendar" or "pick the next topic".

jeremylongshore/tons-of-skills-marketplace

Configure CI/CD pipeline for AppFolio property management integrations. Trigger: "appfolio CI".

jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common AppFolio API integration errors. Trigger: "appfolio error".

jeremylongshore/tons-of-skills-marketplace

Build property management dashboard with AppFolio API data. Trigger: "appfolio property dashboard".

jeremylongshore/tons-of-skills-marketplace

Collect AppFolio API debug evidence for support tickets. Trigger: "appfolio debug".

jeremylongshore/tons-of-skills-marketplace

Deploy AppFolio integration service to cloud infrastructure. Trigger: "deploy appfolio".

jeremylongshore/tons-of-skills-marketplace

Query AppFolio properties, units, and tenants via REST API. Trigger: "appfolio hello world".

jeremylongshore/tons-of-skills-marketplace

Configure AppFolio Stack API authentication with OAuth 2.0. Use when setting up property management API access, registering as an AppFolio Stack partner, or configuring client credentials for API calls. Trigger: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

jeremylongshore/tons-of-skills-marketplace

Set up local development for AppFolio property management API integration. Trigger: "appfolio local dev".

jeremylongshore/tons-of-skills-marketplace

Production readiness checklist for AppFolio integrations. Trigger: "appfolio production checklist".

jeremylongshore/tons-of-skills-marketplace

Handle AppFolio API rate limits with throttling and backoff. Trigger: "appfolio rate limit".

jeremylongshore/tons-of-skills-marketplace

Reference architecture for AppFolio property management integration. Trigger: "appfolio architecture".

jeremylongshore/tons-of-skills-marketplace

Apply production-ready patterns for AppFolio REST API integration. Trigger: "appfolio patterns".

Skills relacionados