Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Automatize o gerenciamento de inquilinos e operações de locação com o AppFolio.

O que é tons-of-skills-marketplace?

Esta skill capacita agentes de IA a gerenciar o ciclo de vida completo de ordens de serviço de manutenção através da API Stack do AppFolio. Ela é especialmente útil para equipes de propriedade imobiliária que precisam automatizar desde a criação de ordens de serviço a partir de solicitações de manutenção de inquilinos até a atribuição de fornecedores, o acompanhamento do progresso dos reparos e o fechamento de trabalhos concluídos com registros de custos. Suporta ações como criação de ordens de serviço, atribuição de fornecedores com janelas de agendamento, consulta de status e fechamento com detalhamento de custos e notas de resolução. A skill também inclui tratamento de erros para códigos de status HTTP comuns e práticas recomendadas como idempotência e minimização de dados, garantindo que as automações sejam seguras e confiáveis em ambientes de sandbox.

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

Perguntar na sua IA favorita

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

Documentação

AppFolio — Ordens de Serviço e Manutenção

Visão Geral

Gerencie o ciclo de vida completo de ordens de serviço de manutenção através da API Stack do AppFolio. Use este fluxo de trabalho quando inquilinos enviarem solicitações de manutenção, quando precisar atribuir fornecedores a ordens de serviço abertas, acompanhar o progresso dos reparos em todas as propriedades ou finalizar trabalhos concluídos com registros de custos. Este é o fluxo de trabalho secundário — para painéis de propriedade e locação, veja appfolio-core-workflow-a.

Pré-requisitos

  • Um contrato AppFolio verificado e um portfólio sandbox com registros sintéticos de propriedade, unidade, fornecedor e ordem de serviço; não teste a automação de manutenção contra uma unidade de produção ocupada.
  • Uma identidade de serviço com privilégios mínimos, suporte a idempotência para ações de criação/fechamento, e um caminho de escalonamento aprovado para manutenção crítica de segurança.
  • Uma política de minimização de dados: armazene e transmita apenas os fatos de manutenção necessários para realizar o trabalho, nunca preferências de inquilinos, códigos de acesso ou informações detalhadas de ocupação em notas ou registros genéricos de fornecedores.

Instruções

Etapa 1: Criar uma Ordem de Serviço a partir de uma Solicitação de Manutenção

const workOrder = await client.workOrders.create({
  property_id: 'prop_4821',
  unit_id: 'unit_12B',
  category: 'plumbing',
  priority: 'high',
  description: 'Vazamento sintético de encanamento reportado na unidade sandbox',
  requested_by: 'tenant_8934',
  due_date: '2026-04-10',
});
console.log(`Ordem de serviço ${workOrder.id} criada — status: ${workOrder.status}`);

Etapa 2: Atribuir um Fornecedor

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: 'Confirme o agendamento através do canal de ordem de serviço aprovado.',
});
console.log(`Atribuído a ${assignment.vendor_name} em ${assignment.scheduled_date}`);

Etapa 3: Acompanhar o Status da Ordem de Serviço

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} (vencimento ${wo.due_date})`)
);

Etapa 4: Fechar Ordem de Serviço com Registro de Custos

const closed = await client.workOrders.close(workOrder.id, {
  resolution: 'Substituído o sifão e apertado a linha de abastecimento. Sem mais vazamentos.',
  labor_cost: 175.00,
  materials_cost: 42.50,
  completed_date: '2026-04-08',
  attachments: ['receipt_plumb_0408.pdf'],
});
console.log(`Fechada #${closed.id} — custo total: $${closed.total_cost}`);

Tratamento de Erros

ProblemaCausaCorreção
401 UnauthorizedCredenciais de API expiradas ou inválidasAtualize client_id/secret no painel Stack
404 Work Order Not FoundID da ordem de serviço errado ou já excluídaVerifique o ID com workOrders.list()
422 Missing required fieldsCategoria ou property_id omitidosInclua todos os campos obrigatórios conforme esquema
409 ConflictOrdem de serviço já fechadaVerifique o status antes de tentar fechar
429 Rate LimitedExcedido 120 requisições/minutoAdicione backoff exponencial com atraso base de 1s

Saída

Uma execução bem-sucedida cria uma ordem de serviço, atribui a um fornecedor com uma janela de serviço agendada e a fecha com registros de custos e notas de resolução. O administrador da propriedade obtém uma trilha de auditoria completa, desde a solicitação até a conclusão.

Exemplos

Para um fluxo de trabalho de encanamento em sandbox, crie uma ordem de serviço sintética com uma chave de idempotência estável, atribua um fornecedor sandbox e leia seu status antes de qualquer transição. Anexe apenas um recibo de teste não sensível, depois feche a ordem uma vez e verifique o total e o registro de auditoria sem registrar detalhes do inquilino ou de acesso. Repita a mesma solicitação para provar que ordens de serviço duplicadas e registros de custos duplicados são rejeitados. Se a atribuição do fornecedor, classificação de segurança, estado anterior ou resultado do fechamento forem incertos, deixe a ordem aberta e encaminhe-a ao operador de propriedade autorizado para revisão.

Recursos

Próximos Passos

Veja appfolio-sdk-patterns para configuração de autenticação e auxiliares de paginação.

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

Habilidades Relacionadas