Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Recopila evidencia de depuración de la API de AppFolio para tickets de soporte.

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

Esta habilidad (skill) para agentes de IA, desencadenada por "appfolio debug", genera un paquete de depuración (debug bundle) que recopila evidencia de diagnóstico de integraciones con la API de gestión de propiedades de AppFolio, con el objetivo de facilitar la escalación de soporte y el análisis de causa raíz. Es útil porque automatiza la recopilación de información crítica como el estado de conectividad a endpoints (propiedades, inquilinos, órdenes de trabajo), el estado de autenticación, las cabeceras de límite de velocidad, los inventarios de logs y las versiones de dependencias, todo sin exponer datos sensibles (cuerpos de respuesta, credenciales o datos de inquilinos/pagos) y minimizando el riesgo de fuga de información. Funciona en cualquier entorno que tenga instalados `curl`, `jq` y `tar` (Linux/macOS, y WSL en Windows) y requiere que las variables de entorno `APPFOLIO_CLIENT_ID`, `APPFOLIO_CLIENT_SECRET` y `APPFOLIO_BASE_URL` estén configuradas. El script de shell incluido crea un archivo tarball listo para compartir a través de canales de soporte aprobados, y el análisis posterior se realiza con comandos estándar como `cat` y `jq`.

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-debug-bundle

Preguntar en tu IA favorita

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

Documentación

Paquete de Depuración de AppFolio

Descripción General

Este paquete de depuración recopila evidencia de diagnóstico de las integraciones con la API de gestión de propiedades de AppFolio para la escalación de soporte y el análisis de causa raíz. Captura la conectividad de la API contra los endpoints de propiedades, inquilinos y órdenes de trabajo, el estado de autenticación utilizando el par de credenciales del cliente, los registros de errores recientes de las canalizaciones de integración y la información de la versión del SDK. El tarball resultante proporciona a los ingenieros de soporte todo lo que necesitan para diagnosticar fallos de conectividad, rechazos de autenticación y problemas de sincronización de datos sin requerir acceso en vivo a su entorno.

Requisitos Previos

  • Tener instalados curl, jq, tar
  • Tener configuradas las variables de entorno APPFOLIO_CLIENT_ID y APPFOLIO_CLIENT_SECRET (par de autenticación básica)
  • Tener configurada APPFOLIO_BASE_URL apuntando a la base de su API Stack (por ejemplo, https://suempresa.appfolio.com/api/v1)

Instrucciones

  1. Obtenga la aprobación del incidente y defina la ventana de tiempo afectada, el portafolio y las sondas seguras de solo lectura; no recopile cuerpos de inquilinos, arrendamientos, pagos o registros sin procesar solo porque estén disponibles.
  2. Cree el paquete con el estado de configuración redactado, el estado/latencia del proveedor, las cabeceras de límite de velocidad y solo las versiones de los paquetes; mantenga las credenciales fuera de argv.
  3. Revise cada archivo antes de compartirlo, cifre o utilice el canal de soporte aprobado para el archivo, y elimine la copia local de acuerdo con la política del incidente.
  4. Si la evidencia requiere registros sensibles, deténgase y obtenga una exportación mínima aprobada por separado en lugar de expandir este paquete de depuración de propósito general.

Script de Recopilación de Depuración

#!/bin/bash
set -euo pipefail
BUNDLE="debug-appfolio-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BUNDLE"

NETRC_FILE="$(mktemp)"
trap 'rm -f "$NETRC_FILE"' EXIT
chmod 600 "$NETRC_FILE"
APPFOLIO_HOST="${APPFOLIO_BASE_URL#https://}"
APPFOLIO_HOST="${APPFOLIO_HOST%%/*}"
printf 'machine %s login %s password %s\n' "$APPFOLIO_HOST" \
  "$APPFOLIO_CLIENT_ID" "$APPFOLIO_CLIENT_SECRET" > "$NETRC_FILE"

probe() {
  endpoint="$1"
  curl -s -o /dev/null -w 'HTTP %{http_code} in %{time_total}s\n' \
    --netrc-file "$NETRC_FILE" "${APPFOLIO_BASE_URL}/${endpoint}?per_page=1" \
    || printf 'UNREACHABLE\n'
}

# Verificación del entorno
echo "=== Environment ===" > "$BUNDLE/environment.txt"
echo "Base URL: ${APPFOLIO_BASE_URL:-NOT SET}" >> "$BUNDLE/environment.txt"
echo "Client ID: ${APPFOLIO_CLIENT_ID:+SET (redactado)}" >> "$BUNDLE/environment.txt"
echo "Client Secret: ${APPFOLIO_CLIENT_SECRET:+SET (redactado)}" >> "$BUNDLE/environment.txt"
echo "Node: $(node -v 2>/dev/null || echo 'no instalado')" >> "$BUNDLE/environment.txt"
echo "Timestamp: $(date -u)" >> "$BUNDLE/environment.txt"

# Metadatos de conectividad de la API únicamente: nunca escribir cuerpos de API en este paquete.
echo "=== API Health ===" > "$BUNDLE/api-health.txt"
probe properties >> "$BUNDLE/api-health.txt"

# Sonda del endpoint de órdenes de trabajo
echo "=== Work Orders ===" > "$BUNDLE/work-orders.txt"
probe work_orders >> "$BUNDLE/work-orders.txt"

# Sonda del endpoint de inquilinos
echo "=== Tenants ===" > "$BUNDLE/tenants.txt"
probe tenants >> "$BUNDLE/tenants.txt"

# Solo inventario de registros; los registros sin procesar pueden contener datos de inquilinos y financieros.
echo "=== Log Inventory ===" > "$BUNDLE/app-logs.txt"
find /var/log/appfolio-sync -maxdepth 1 -type f -printf '%f %s bytes\n' 2>/dev/null \
  || echo "No se encontraron registros de sincronización" >> "$BUNDLE/app-logs.txt"

# Cabeceras de límite de velocidad
echo "=== Rate Limits ===" > "$BUNDLE/rate-limits.txt"
curl -sI --netrc-file "$NETRC_FILE" \
  "${APPFOLIO_BASE_URL}/properties?per_page=1" 2>/dev/null | grep -i "x-rate\|retry-after\|x-ratelimit" >> "$BUNDLE/rate-limits.txt" || echo "No hay cabeceras de límite de velocidad" >> "$BUNDLE/rate-limits.txt"

# Versiones de paquetes
echo "=== Dependencies ===" > "$BUNDLE/deps.txt"
npm ls 2>/dev/null | grep -i appfolio >> "$BUNDLE/deps.txt" || echo "No se encontraron paquetes npm de AppFolio" >> "$BUNDLE/deps.txt"

tar -czf "$BUNDLE.tar.gz" "$BUNDLE" && rm -rf "$BUNDLE"
echo "Bundle: $BUNDLE.tar.gz"

Análisis del Paquete

tar -xzf debug-appfolio-*.tar.gz
cat debug-appfolio-*/environment.txt     # Verificar que las credenciales están configuradas
cat debug-appfolio-*/api-health.txt      # Comprobar el estado HTTP y la latencia
cat debug-appfolio-*/rate-limits.txt     # Confirmar que no hay límite de velocidad
jq '.errors' debug-appfolio-*/work-orders.txt 2>/dev/null  # Analizar las cargas de error

Problemas Comunes

SíntomaRevisar en el PaqueteSolución
401 en todos los endpointsenvironment.txt muestra client ID/secret NO CONFIGURADOSConfigure APPFOLIO_CLIENT_ID y APPFOLIO_CLIENT_SECRET en el entorno
403 Prohibido en inquilinostenants.txt HTTP 403Falta el alcance de la API Stack; solicite permiso de lectura de inquilinos en el portal de socios de AppFolio
429 Demasiadas Solicitudesrate-limits.txt muestra la cabecera retry-afterReduzca la velocidad e implemente reintentos exponenciales; AppFolio permite 120 solicitudes/min
Tiempo de espera en órdenes de trabajoapi-health.txt muestra tiempo > 30sReduzca el parámetro per_page; filtre por updated_since para acotar el conjunto de resultados
Lista de propiedades vacíaapi-health.txt devuelve []Verifique que APPFOLIO_BASE_URL apunte al portafolio correcto; compruebe los filtros de grupo de propiedades
Error de certificado SSLapi-health.txt muestra error SSL de curlActualice el paquete de CA: sudo update-ca-certificates; compruebe la configuración del proxy

Salida

  • Un paquete revisable y redactado de presencia de configuración, estado y latencia de endpoints, cabeceras de límite de velocidad, inventario de registros y metadatos de dependencias
  • Un acuse de recibo de entrega a soporte que nombra el alcance del incidente y las exclusiones de datos sensibles, en lugar de empaquetar registros de inquilinos, pagos o aplicaciones sin procesar
  • Una decisión de cierre por fallo cuando la evidencia requerida no se puede recopilar de forma segura

Manejo de Errores

Trate un fallo de sonda como evidencia de una sonda fallida, no como permiso para capturar respuestas más grandes o eludir los controles de credenciales. Para 401/403, verifique la configuración del cliente gestionado con el propietario de la credencial; para 429, conserve las cabeceras de límite de velocidad y detenga más sondas; para 5xx o tiempo de espera, recopile solo la evidencia de tiempo/estado redactada y consulte la página de estado del proveedor. Si el soporte necesita un registro específico de inquilino o pago, utilice una exportación mínima aprobada por separado con sus propios controles de retención y acceso.

Ejemplos

Para un tiempo de espera de sincronización en producción, cree un paquete que cubra la ventana de tiempo afectada y una sonda segura de solo lectura de propiedades. Confirme que contiene estado/latencia, cabeceras de límite de velocidad, versiones de dependencias y metadatos de archivos de registro, pero ningún cuerpo de respuesta, credencial, dato de inquilino o financiero. Revise el archivo antes de subirlo al canal de soporte cifrado aprobado. Si la revisión encuentra una carga útil sin procesar o un secreto, elimine el archivo, rote según corresponda y regenere un paquete minimizado antes de la escalación.

Verificación Automatizada de Salud

async function checkAppFolioHealth(): Promise<{
  status: string;
  latencyMs: number;
  endpoints: Record<string, number>;
}> {
  const baseUrl = process.env.APPFOLIO_BASE_URL;
  const creds = Buffer.from(
    `${process.env.APPFOLIO_CLIENT_ID}:${process.env.APPFOLIO_CLIENT_SECRET}`
  ).toString("base64");
  const headers = { Authorization: `Basic ${creds}` };
  const endpoints = ["properties", "tenants", "work_orders"];
  const results: Record<string, number> = {};
  const start = Date.now();
  for (const ep of endpoints) {
    const res = await fetch(`${baseUrl}/${ep}?per_page=1`, { headers });
    results[ep] = res.status;
  }
  return {
    status: Object.values(results).every((s) => s === 200) ? "healthy" : "degraded",
    latencyMs: Date.now() - start,
    endpoints: results,
  };
}

Recursos

Próximos Pasos

Consulte appfolio-rate-limits.

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

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

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