Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Crea un panel de gestión de propiedades utilizando datos de la API de AppFolio.

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

Este skill automatiza la integración con AppFolio para la gestión completa de propiedades e inquilinos. Permite crear y actualizar registros de propiedades, gestionar perfiles de inquilinos y contratos de arrendamiento, y consultar datos de ocupación. Utiliza la API Stack de AppFolio con autenticación OAuth 2.0 para acceso servidor a servidor. Diseñado para asistentes de IA como Claude Code, Cursor o Codex, este skill incluye ejemplos de código TypeScript, manejo de errores y pasos claros para flujos de creación y consulta, todo con soporte para paginación mediante parámetros `cursor`.

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-a

Preguntar en tu IA favorita

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

Documentación

AppFolio — Gestión de Propiedades e Inquilinos

Resumen

Flujo de trabajo principal para la integración de gestión de propiedades con AppFolio. Cubre el ciclo de vida completo de una propiedad: crear y actualizar registros de propiedades, gestionar perfiles de inquilinos y contratos de arrendamiento, y consultar datos de ocupación. Utiliza la API Stack de AppFolio con credenciales de cliente OAuth 2.0 para acceso servidor a servidor. Todos los endpoints devuelven JSON y admiten paginación mediante parámetros cursor para carteras grandes.

Requisitos previos

  • Un contrato actual de socio/API de AppFolio que confirme la URL base de la cartera asignada, el método de autenticación, los alcances aprobados y las capacidades de escritura; no inferir estos datos de un tutorial o de otra cartera.
  • Un sandbox separado con propiedades, unidades y registros sintéticos de inquilinos, además de un propietario de credenciales y un presupuesto de solicitudes aprobado.
  • Claves de idempotencia y un proceso de reversión/reconciliación aprobado por el operador para escrituras de propiedades, inquilinos y arrendamientos, que pueden tener consecuencias legales y de facturación reales.

Instrucciones

  1. Confirmar la URL base y el flujo de autenticación proporcionados por el proveedor para la cartera objetivo antes de copiar cualquier configuración de cliente en un entorno.
  2. Ejecutar la ruta de creación/actualización solo con datos sintéticos del sandbox y claves de idempotencia; recuperar registros canónicos antes de reintentar una escritura incierta.
  3. Validar la propiedad, las fechas del arrendamiento y la disponibilidad de la unidad antes de crear un arrendamiento, y emitir solo identificadores de registro y evidencia de estado resumida.
  4. Promover un flujo con capacidad de escritura solo después de que un ensayo por etapas demuestre la reversión, la reconciliación y el límite de alcance de menor privilegio.

Paso 1: Autenticar e Inicializar Cliente

const token = await fetch('https://api.appfolio.com/oauth/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    grant_type: 'client_credentials',
    client_id: process.env.APPFOLIO_CLIENT_ID!,
    client_secret: process.env.APPFOLIO_CLIENT_SECRET!,
    scope: 'properties tenants leases',
  }),
}).then(r => r.json());
const headers = { Authorization: `Bearer ${token.access_token}`, 'Content-Type': 'application/json' };

Paso 2: Crear o Actualizar una Propiedad

const property = await fetch('https://api.appfolio.com/v1/properties', {
  method: 'POST', headers,
  body: JSON.stringify({
    name: 'Sunrise Apartments',
    address: { street: '100 Main St', city: 'Austin', state: 'TX', zip: '78701' },
    type: 'residential',
    units: [
      { number: '101', bedrooms: 2, bathrooms: 1, rent: 1450 },
      { number: '102', bedrooms: 1, bathrooms: 1, rent: 1100 },
    ],
  }),
}).then(r => r.json());
console.log(`Property created: ${property.id}`);

Paso 3: Agregar un Inquilino y un Arrendamiento

const tenant = await fetch('https://api.appfolio.com/v1/tenants', {
  method: 'POST', headers,
  body: JSON.stringify({
    first_name: 'Test', last_name: 'Tenant',
    email: '[email protected]', phone: '555-0100',
  }),
}).then(r => r.json());

await fetch('https://api.appfolio.com/v1/leases', {
  method: 'POST', headers,
  body: JSON.stringify({
    property_id: property.id, unit_number: '101',
    tenant_id: tenant.id, start_date: '2026-05-01', end_date: '2027-04-30',
    monthly_rent: 1450, security_deposit: 1450,
  }),
}).then(r => r.json());

Paso 4: Consultar Ocupación

const units = await fetch(
  `https://api.appfolio.com/v1/properties/${property.id}/units?status=vacant`,
  { headers },
).then(r => r.json());
console.log(`Vacant units: ${units.data.length} of ${units.meta.total}`);

Manejo de Errores

ProblemaCausaSolución
401 UnauthorizedToken expirado o inválidoReautenticar con credenciales de cliente
404 Not FoundID de propiedad/inquilino incorrectoVerificar que el ID del recurso exista antes de referenciarlo
422 UnprocessableFaltan campos requeridosRevisar el arreglo errors[] en el cuerpo de la respuesta
409 ConflictArrendamiento duplicado para la unidadConsultar arrendamientos existentes antes de crear
429 Too Many RequestsLímite de tasa excedidoRetroceder usando el valor del encabezado Retry-After

Salida

Una ejecución exitosa crea una propiedad con unidades, agrega un inquilino, los vincula mediante un arrendamiento y reporta los conteos de vacantes. La salida de consola confirma cada ID de recurso en la creación.

Ejemplos

Para un cambio de creación de arrendamiento, ejecutar contra una unidad y un inquilino sintéticos con nombre en un sandbox, utilizando una clave de idempotencia estable. Leer la propiedad y los arrendamientos actuales, realizar la escritura candidata una vez, luego leer el arrendamiento resultante y registrar solo IDs, fechas y el estado de reconciliación. Re-ejecutar la misma solicitud para comprobar que no crea un segundo arrendamiento. Si no se puede verificar el contrato del proveedor, el endpoint, la autorización o el resultado de la escritura anterior, detenerse antes de cualquier escritura y enviar el caso al operador de la cartera para reconciliación.

Recursos

Próximos Pasos

Continuar con appfolio-core-workflow-b para solicitudes de mantenimiento y seguimiento de pagos.

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

Automate tenant management and lease operations with AppFolio. Trigger: "appfolio tenant management".

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