Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Colete evidências de depuração da API AppFolio para tickets de suporte.

O que é tons-of-skills-marketplace?

Esta skill gera um pacote de depuração que coleta evidências de diagnóstico de integrações com a API de gerenciamento de propriedades AppFolio para análise de causa raiz e escalonamento de suporte. Ela captura a conectividade da API nos endpoints de propriedades, inquilinos e ordens de serviço, o status de autenticação usando pares de credenciais do cliente, logs de erro recentes de pipelines de integração e informações de versão do SDK. O tarball resultante fornece aos engenheiros de suporte tudo o que precisam para diagnosticar falhas de conectividade, rejeições de autenticação e problemas de sincronização de dados sem exigir acesso direto ao ambiente. A skill é acionada pelo comando "appfolio debug" e suporta plataformas como Claude Code, Cursor e Codex, garantindo que a coleta siga práticas seguras, evitando a captura de dados sensíveis.

Funciona com✓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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pacote de Depuração AppFolio

Visão Geral

Este pacote de depuração coleta evidências de diagnóstico de integrações com a API de gerenciamento de propriedades AppFolio para escalonamento de suporte e análise de causa raiz. Ele captura a conectividade da API nos endpoints de propriedades, inquilinos e ordens de serviço, o status de autenticação usando pares de credenciais do cliente, logs de erro recentes de pipelines de integração e informações de versão do SDK. O tarball resultante fornece aos engenheiros de suporte tudo o que precisam para diagnosticar falhas de conectividade, rejeições de autenticação e problemas de sincronização de dados sem exigir acesso direto ao seu ambiente.

Pré-requisitos

  • curl, jq, tar instalados
  • APPFOLIO_CLIENT_ID e APPFOLIO_CLIENT_SECRET configurados (par de autenticação básica)
  • APPFOLIO_BASE_URL definido para a base da sua API Stack (ex.: https://yourcompany.appfolio.com/api/v1)

Instruções

  1. Obtenha aprovação do incidente e defina a janela de tempo afetada, o portfólio e as sondas de leitura segura; não colete corpos de inquilinos, contratos de locação, pagamentos ou logs brutos meramente porque estão disponíveis.
  2. Crie o pacote com estado de configuração redigido, status/latência do provedor, cabeçalhos de limite de taxa e versões de pacotes apenas; mantenha as credenciais fora de argv.
  3. Revise cada arquivo antes de compartilhar, criptografe ou use o canal de suporte aprovado para o arquivo e exclua a cópia local de acordo com a política de incidentes.
  4. Se as evidências exigirem registros sensíveis, pare e obtenha uma exportação mínima aprovada separadamente, em vez de expandir este pacote de depuração de uso geral.

Script de Coleta de Depuração

#!/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'
}

# Verificação de ambiente
echo "=== Environment ===" > "$BUNDLE/environment.txt"
echo "Base URL: ${APPFOLIO_BASE_URL:-NOT SET}" >> "$BUNDLE/environment.txt"
echo "Client ID: ${APPFOLIO_CLIENT_ID:+SET (redacted)}" >> "$BUNDLE/environment.txt"
echo "Client Secret: ${APPFOLIO_CLIENT_SECRET:+SET (redacted)}" >> "$BUNDLE/environment.txt"
echo "Node: $(node -v 2>/dev/null || echo 'not installed')" >> "$BUNDLE/environment.txt"
echo "Timestamp: $(date -u)" >> "$BUNDLE/environment.txt"

# Metadados de conectividade da API apenas — nunca escreva corpos de API neste pacote.
echo "=== API Health ===" > "$BUNDLE/api-health.txt"
probe properties >> "$BUNDLE/api-health.txt"

# Sonda do endpoint de ordens de serviço
echo "=== Work Orders ===" > "$BUNDLE/work-orders.txt"
probe work_orders >> "$BUNDLE/work-orders.txt"

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

# Inventário de logs apenas; logs brutos podem conter dados de inquilinos e financeiros.
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 sync logs found" >> "$BUNDLE/app-logs.txt"

# Cabeçalhos de limite de taxa
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 rate limit headers" >> "$BUNDLE/rate-limits.txt"

# Versões de pacotes
echo "=== Dependencies ===" > "$BUNDLE/deps.txt"
npm ls 2>/dev/null | grep -i appfolio >> "$BUNDLE/deps.txt" || echo "No AppFolio npm packages found" >> "$BUNDLE/deps.txt"

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

Analisando o Pacote

tar -xzf debug-appfolio-*.tar.gz
cat debug-appfolio-*/environment.txt     # Verifica se as credenciais estão definidas
cat debug-appfolio-*/api-health.txt      # Verifica status HTTP e latência
cat debug-appfolio-*/rate-limits.txt     # Confirma que não está com limitação
jq '.errors' debug-appfolio-*/work-orders.txt 2>/dev/null  # Analisa payloads de erro

Problemas Comuns

SintomaVerificar no PacoteCorreção
401 em todos os endpointsenvironment.txt mostra client ID/secret NOT SETDefina APPFOLIO_CLIENT_ID e APPFOLIO_CLIENT_SECRET no ambiente
403 Forbidden em inquilinostenants.txt HTTP 403Escopo da API Stack ausente; solicite permissão de leitura de inquilinos no portal de parceiros AppFolio
429 Muitas Requisiçõesrate-limits.txt mostra cabeçalho retry-afterRecue e implemente retry exponencial; AppFolio permite 120 req/min
Timeout em ordens de serviçoapi-health.txt mostra tempo > 30sReduza o parâmetro per_page; filtre por updated_since para restringir o conjunto de resultados
Lista de propriedades vaziaapi-health.txt retorna []Verifique se APPFOLIO_BASE_URL aponta para o portfólio correto; verifique filtros de grupo de propriedades
Erro de certificado SSLapi-health.txt mostra erro SSL do curlAtualize o pacote CA: sudo update-ca-certificates; verifique configurações de proxy

Saída

  • Um pacote revisável e redigido de presença de configuração, status e latência de endpoint, cabeçalhos de limite de taxa, inventário de logs e metadados de dependências
  • Um recibo de transferência de suporte que nomeia o escopo do incidente e as exclusões de dados sensíveis, em vez de empacotar registros de inquilinos, pagamentos ou aplicativos brutos
  • Uma decisão de falha fechada quando as evidências necessárias não podem ser coletadas com segurança

Tratamento de Erros

Trate uma falha de sonda como evidência de uma sonda falha, não como permissão para capturar respostas maiores ou ignorar controles de credenciais. Para 401/403, verifique a configuração do cliente gerenciado com o proprietário da credencial; para 429, preserve os cabeçalhos de taxa e pause as sondas adicionais; para 5xx ou timeout, colete apenas as evidências redigidas de tempo/status e verifique a página de status do provedor. Se o suporte precisar de um registro específico de inquilino ou pagamento, use uma exportação mínima aprovada separadamente com seus próprios controles de retenção e acesso.

Exemplos

Para um timeout de sincronização de produção, crie um pacote cobrindo a janela de tempo afetada e uma sonda de leitura segura de propriedades. Confirme que contém status/latência, cabeçalhos de taxa, versões de dependências e metadados de arquivos de log — mas nenhum corpo de resposta, credencial, inquilino ou dado financeiro. Revise o arquivo antes de enviá-lo para o canal de suporte criptografado aprovado. Se a revisão encontrar um payload bruto ou segredo, exclua o arquivo, rotacione conforme apropriado e regenere um pacote minimizado antes do escalonamento.

Verificação Automática de Saúde

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 Passos

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".

Habilidades Relacionadas