Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Automatisez la gestion des locataires et les opérations de bail avec AppFolio.

Qu'est-ce que tons-of-skills-marketplace ?

Ce skill automatise la gestion des ordres de travail de maintenance via l'API Stack d'AppFolio, en couvrant l'ensemble du cycle : création d'ordres de travail à partir de demandes de maintenance, affectation de prestataires, suivi des statuts et clôture avec enregistrement des coûts. Il est conçu pour les gestionnaires immobiliers et les développeurs qui utilisent AppFolio sur Claude Code, Cursor ou Codex. Le skill nécessite un contrat AppFolio vérifié, un portfolio sandbox avec données synthétiques, et une identité de service à privilèges minimaux pour éviter les incidents en production. Il inclut des instructions étape par étape en TypeScript, une gestion des erreurs avec codes d'état HTTP, et des exemples de tests sandbox pour prouver l'idempotence et la sécurité.

Compatible avec✓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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

AppFolio — Ordres de travail & Maintenance

Vue d'ensemble

Gérez le cycle de vie complet des ordres de travail de maintenance via l'API Stack d'AppFolio. Utilisez ce workflow lorsque les locataires soumettent des demandes de maintenance, lorsque vous devez affecter prestataires à des ordres de travail ouverts, suivre l'avancement des réparations sur plusieurs propriétés, ou clôturer des jobs terminés avec enregistrement des coûts. Il s'agit du workflow secondaire — pour les tableaux de bord de propriété et la location, voir appfolio-core-workflow-a.

Prérequis

  • Un contrat AppFolio vérifié et un portfolio sandbox avec des enregistrements synthétiques de propriété, d'unité, de prestataire et d'ordre de travail ; ne testez pas l'automatisation de la maintenance sur une unité de production occupée.
  • Une identité de service à privilèges minimaux, un support d'idempotence pour les actions de création/clôture, et un chemin d'escalade approuvé pour la maintenance critique.
  • Une politique de minimisation des données : stockez et transmettez uniquement les faits de maintenance nécessaires pour effectuer le travail, jamais les préférences des locataires, les codes d'accès, ou les informations détaillées d'occupation dans les notes ou journaux génériques des prestataires.

Instructions

Étape 1 : Créer un ordre de travail à partir d'une demande de maintenance

const workOrder = await client.workOrders.create({
  property_id: 'prop_4821',
  unit_id: 'unit_12B',
  category: 'plumbing',
  priority: 'high',
  description: 'Fuite de plomberie synthétique signalée dans l\'unité sandbox',
  requested_by: 'tenant_8934',
  due_date: '2026-04-10',
});
console.log(`Ordre de travail ${workOrder.id} créé — statut: ${workOrder.status}`);

Étape 2 : Affecter un prestataire

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: 'Confirmez le rendez-vous programmé via le canal d\'ordre de travail approuvé.',
});
console.log(`Affecté à ${assignment.vendor_name} le ${assignment.scheduled_date}`);

Étape 3 : Suivre le statut de l'ordre de travail

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

Étape 4 : Clôturer l'ordre de travail avec enregistrement des coûts

const closed = await client.workOrders.close(workOrder.id, {
  resolution: 'Remplacement du siphon et serrage de la conduite d\'alimentation. Plus de fuites.',
  labor_cost: 175.00,
  materials_cost: 42.50,
  completed_date: '2026-04-08',
  attachments: ['receipt_plumb_0408.pdf'],
});
console.log(`Clôturé #${closed.id} — coût total: $${closed.total_cost}`);

Gestion des erreurs

ProblèmeCauseCorrectif
401 Non autoriséIdentifiants API expirés ou invalidesRafraîchir client_id/secret dans le tableau de bord Stack
404 Ordre de travail non trouvéMauvais ID d'ordre de travail ou déjà suppriméVérifier l'ID avec workOrders.list()
422 Champs obligatoires manquantsCatégorie ou property_id omisInclure tous les champs obligatoires selon le schéma
409 ConflitOrdre de travail déjà clôturéVérifier le statut avant de tenter la clôture
429 Limite de débit atteinteDépassement de 120 requêtes/minuteAjouter un backoff exponentiel avec délai de base de 1s

Résultat

Un exécution réussie crée un ordre de travail, l'affecte à un prestataire avec une fenêtre de service programmée, et le clôture avec des enregistrements de coûts et des notes de résolution. Le gestionnaire de propriété dispose d'une piste d'audit complète, de la demande à la réalisation.

Exemples

Pour un workflow de plomberie sandbox, créez un ordre de travail synthétique avec une clé d'idempotence stable, affectez un prestataire sandbox, et relisez son statut avant toute transition. Joignez uniquement un reçu de test non sensible, puis clôturez l'ordre une fois et vérifiez le total et l'enregistrement d'audit sans journaliser les détails du locataire ou d'accès. Rejouez la même requête pour prouver que les doublons d'ordres de travail et de coûts sont rejetés. Si l'affectation du prestataire, la classification de sécurité, l'état antérieur, ou le résultat de la clôture sont incertains, laissez l'ordre ouvert et acheminez-le vers l'opérateur de propriété autorisé pour examen.

Ressources

Prochaines étapes

Voir appfolio-sdk-patterns pour la configuration de l'authentification et les aides de pagination.

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

Skills associés