Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

Automatisieren Sie die Mieterverwaltung und Mietvertragsabläufe mit AppFolio.

Was ist tons-of-skills-marketplace?

Diese Skill-Anleitung beschreibt, wie der vollständige Lebenszyklus von Wartungsarbeitsaufträgen über die AppFolio Stack API verwaltet wird. Sie ist für Entwickler und KI-Agenten gedacht, die Arbeitsabläufe im Immobilienmanagement automatisieren möchten. Die Anleitung führt Schritt für Schritt durch die Erstellung eines Arbeitsauftrags aus einer Wartungsanfrage, die Zuweisung eines Dienstleisters, die Verfolgung des Status und den Abschluss mit Kostenerfassung. Sie behandelt Fehlerbehandlungsszenarien wie Authentifizierungsfehler, fehlende Felder und Ratenbegrenzung, wobei der Schwerpunkt auf der Verwendung von Sandbox-Daten und der Sicherstellung von Idempotenz liegt. Die Zielplattform ist AppFolio Stack, und die Anleitung enthält Codebeispiele in TypeScript sowie Verweise auf die offizielle API-Dokumentation.

Funktioniert mit✓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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

AppFolio — Arbeitsaufträge & Wartung

Übersicht

Verwalten Sie den vollständigen Lebenszyklus von Wartungsarbeitsaufträgen über die AppFolio Stack API. Nutzen Sie diesen Workflow, wenn Mieter Wartungsanfragen einreichen, wenn Sie offenen Arbeitsaufträgen Dienstleister zuweisen müssen, den Reparaturfortschritt über verschiedene Liegenschaften hinweg verfolgen oder abgeschlossene Aufträge mit Kostenaufzeichnungen abschließen möchten. Dies ist der sekundäre Workflow – für Liegenschafts-Dashboards und Vermietung siehe appfolio-core-workflow-a.

Voraussetzungen

  • Ein verifizierter AppFolio-Vertrag und ein Sandbox-Portfolio mit synthetischen Liegenschafts-, Einheiten-, Dienstleister- und Arbeitsauftragsdatensätzen; testen Sie die Wartungsautomatisierung nicht gegen eine belegte Produktionseinheit.
  • Eine Service-Identität mit minimalen Berechtigungen, Idempotenz-Unterstützung für Erstellungs-/Abschlussaktionen und ein genehmigter Eskalationspfad für sicherheitskritische Wartungsarbeiten.
  • Eine Datenminimierungsrichtlinie: Speichern und übertragen Sie nur die Wartungsdaten, die zur Durchführung der Arbeiten erforderlich sind, niemals Mieterpräferenzen, Zugangscodes oder detaillierte Belegungsinformationen in allgemeinen Dienstleister-Notizen oder Protokollen.

Anleitung

Schritt 1: Erstellen eines Arbeitsauftrags aus einer Wartungsanfrage

const workOrder = await client.workOrders.create({
  property_id: 'prop_4821',
  unit_id: 'unit_12B',
  category: 'plumbing',
  priority: 'high',
  description: 'Synthetic plumbing fixture leak reported in sandbox unit',
  requested_by: 'tenant_8934',
  due_date: '2026-04-10',
});
console.log(`Work order ${workOrder.id} created — status: ${workOrder.status}`);

Schritt 2: Einen Dienstleister zuweisen

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: 'Confirm scheduled appointment through the approved work-order channel.',
});
console.log(`Assigned to ${assignment.vendor_name} on ${assignment.scheduled_date}`);

Schritt 3: Status des Arbeitsauftrags verfolgen

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

Schritt 4: Arbeitsauftrag mit Kostenaufzeichnung abschließen

const closed = await client.workOrders.close(workOrder.id, {
  resolution: 'Replaced P-trap and tightened supply line. No further leaks.',
  labor_cost: 175.00,
  materials_cost: 42.50,
  completed_date: '2026-04-08',
  attachments: ['receipt_plumb_0408.pdf'],
});
console.log(`Closed #${closed.id} — total cost: $${closed.total_cost}`);

Fehlerbehandlung

ProblemUrsacheBehebung
401 UnauthorizedAbgelaufene oder ungültige API-Anmeldedatenclient_id/secret im Stack-Dashboard aktualisieren
404 Work Order Not FoundFalsche Arbeitsauftrags-ID oder bereits gelöschtID mit workOrders.list() überprüfen
422 Missing required fieldsKategorie oder property_id fehltAlle erforderlichen Felder gemäß Schema angeben
409 ConflictArbeitsauftrag bereits abgeschlossenStatus vor dem Abschlussversuch prüfen
429 Rate LimitedMaximal 120 Anfragen/Minute überschrittenExponentielles Backoff mit 1s Basisverzögerung einbauen

Ausgabe

Ein erfolgreicher Durchlauf erstellt einen Arbeitsauftrag, weist ihn einem Dienstleister mit einem geplanten Service-Fenster zu und schließt ihn mit Kostenaufzeichnungen und Lösungsnotizen ab. Der Hausverwalter erhält einen vollständigen Prüfpfad von der Anfrage bis zum Abschluss.

Beispiele

Für einen Sandbox-Sanitär-Workflow erstellen Sie einen synthetischen Arbeitsauftrag mit einem stabilen Idempotenz-Schlüssel, weisen einen Sandbox-Dienstleister zu und lesen seinen Status vor jedem Übergang zurück. Fügen Sie nur einen nicht sensitiven Testbeleg an, schließen Sie den Auftrag dann einmal ab und überprüfen Sie die Gesamtsumme und den Prüfdatensatz, ohne Mieter- oder Zugangsdetails zu protokollieren. Wiederholen Sie dieselbe Anfrage, um zu beweisen, dass doppelte Arbeitsaufträge und doppelte Kostenaufzeichnungen abgelehnt werden. Wenn die Dienstleisterzuweisung, die Sicherheitsklassifizierung, der vorherige Zustand oder das Abschlussergebnis unsicher sind, lassen Sie den Auftrag offen und leiten Sie ihn an den autorisierten Liegenschaftsbetreiber zur Überprüfung weiter.

Ressourcen

Nächste Schritte

Siehe appfolio-sdk-patterns für Authentifizierungseinrichtung und Paginierungs-Hilfen.

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

Verwandte Skills