Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Construa um painel de gerenciamento de propriedades com dados da API AppFolio.

O que é tons-of-skills-marketplace?

Essa skill integra o agente com a API AppFolio Stack para gerenciar o ciclo completo de propriedades, inquilinos e contratos de locação. Ela usa OAuth 2.0 com credenciais de cliente para autenticação segura servidor a servidor e suporta paginação via parâmetros `cursor` para grandes portfólios. É ideal para corretores e profissionais de propriedades que precisam automatizar tarefas como criar unidades, adicionar inquilinos, registrar contratos e consultar disponibilidade de vacância. A skill exige um contrato AppFolio ativo, um ambiente de sandbox com dados sintéticos para testes, e implementa validações rigorosas, como chaves de idempotência e processos de rollback para evitar consequências legais ou de faturamento.

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

Perguntar na sua IA favorita

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

Documentação

AppFolio — Gerenciamento de Propriedades e Inquilinos

Visão Geral

Fluxo de trabalho principal para integração de gerenciamento de propriedades com AppFolio. Abrange todo o ciclo de vida da propriedade: criar e atualizar registros de propriedades, gerenciar perfis de inquilinos e contratos de locação, e consultar dados de ocupação. Utiliza a API AppFolio Stack com credenciais de cliente OAuth 2.0 para acesso servidor a servidor. Todos os endpoints retornam JSON e suportam paginação via parâmetros cursor para grandes portfólios.

Pré-requisitos

  • Um contrato de parceiro/API AppFolio vigente que confirme a URL base do portfólio atribuído, método de autenticação, escopos aprovados e capacidades de escrita; não inferir esses dados de um tutorial ou de outro portfólio.
  • Um sandbox separado com propriedades, unidades e registros sintéticos de inquilinos, além de um proprietário de credencial e um orçamento de requisições aprovado.
  • Chaves de idempotência e um processo de rollback/reconciliação aprovado pelo operador para escritas de propriedades, inquilinos e contratos, que podem gerar consequências legais e de faturamento reais.

Instruções

  1. Confirme a URL base e o fluxo de autenticação fornecidos pelo provedor para o portfólio alvo antes de copiar qualquer configuração de cliente para um ambiente.
  2. Execute o caminho de criação/atualização apenas com fixtures sintéticas do sandbox e chaves de idempotência; recupere registros canônicos antes de tentar novamente uma escrita incerta.
  3. Valide a propriedade, datas do contrato e disponibilidade da unidade antes de criar um contrato de locação, e emita apenas IDs de registros e evidências de status resumidas.
  4. Promova um fluxo com capacidade de escrita somente após um ensaio encenado que comprove rollback, reconciliação e o limite de escopo de privilégio mínimo.

Passo 1: Autenticar e Inicializar o 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' };

Passo 2: Criar ou Atualizar uma Propriedade

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}`);

Passo 3: Adicionar um Inquilino e Contrato de Locação

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());

Passo 4: Consultar Ocupação

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}`);

Tratamento de Erros

ProblemaCausaCorreção
401 UnauthorizedToken expirado ou inválidoReautenticar com credenciais de cliente
404 Not FoundID de propriedade/inquilino incorretoVerificar se o ID do recurso existe antes de referenciar
422 UnprocessableCampos obrigatórios ausentesVerificar array errors[] no corpo da resposta
409 ConflictContrato duplicado para a unidadeConsultar contratos existentes antes de criar
429 Too Many RequestsLimite de taxa excedidoAguardar usando o valor do cabeçalho Retry-After

Saída

Uma execução bem-sucedida cria uma propriedade com unidades, adiciona um inquilino, vincula-os por meio de um contrato de locação e relata contagens de vacância. A saída do console confirma o ID de cada recurso na criação.

Exemplos

Para uma alteração de criação de contrato, execute contra uma unidade sintética nomeada do sandbox e um inquilino com uma chave de idempotência estável. Leia a propriedade e os contratos atuais, execute a escrita candidata uma vez, depois leia o contrato resultante e registre apenas IDs, datas e o status de reconciliação. Reexecute a mesma requisição para provar que ela não cria um segundo contrato. Se o contrato do provedor, endpoint, autorização ou resultado da escrita anterior não puder ser verificado, pare antes de qualquer escrita e envie o caso para o operador do portfólio para reconciliação.

Recursos

Próximos Passos

Continue com appfolio-core-workflow-b para solicitações de manutenção e rastreamento de pagamentos.

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

Habilidades Relacionadas