Communitygithub.com

mindxassociates/practice-website-kit

Erstelle eine private Praxis-Website mit Astro + PagesCMS + Cloudflare Pages.

Was ist practice-website-kit?

Dieses Skill-Paket unterstützt Therapeuten und andere Anbieter von Gesundheitsdienstleistungen dabei, mit Astro, PagesCMS und Cloudflare Pages eine schnelle, sichere und wartungsarme Praxiswebsite zu erstellen. Die Website ist als reine Publikation konzipiert – Seiten, Profile und Blogbeiträge sind Content, während Buchungen, Zahlungen und Verzeichnisse per iframe von bestehenden Systemen eingebettet werden. Dies vermeidet die Neuerfindung komplexer dynamischer Funktionen. Der Skill behandelt den gesamten Aufbauprozess: vom Einrichtungsinterview über die Erstellung des Astro-Projekts mit Markdown-Content-Collections bis zur Konfiguration des PagesCMS (Git-basiertes CMS, das Content-Ordner in Webformulare verwandelt) und der Bereitstellung auf Cloudflare Pages mit eigenem Domainnamen. Besonderer Wert wird auf therapie-spezifische Anforderungen gelegt: Platzierung von Krisentelefonnummern, Verzicht auf klinische Datenerhebung durch die Website, strukturierte Daten für die Praxis, Sitemap, RSS und llms.txt. Der Agent erstellt ein vollständiges GitHub-Repository, das der Praxis gehört, und stellt die Verbindungen zu PagesCMS, Cloudflare Pages und der Domain her. Vor dem Bau führt er ein Einrichtungsinterview durch, um Fakten wie Praxisnamen, Leistungen, Honorare und Redakteure zu erfragen – niemals werden Inhalte erfunden. Die Prüfung der CMS-Konfiguration anhand einer echten Speicher-Aktion ist der entscheidende Test für den Erfolg.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mindxassociates/ai-skills-for-therapists-in-private-practice/tree/HEAD/practice-website-kit
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Practice Website Kit – Astro + PagesCMS + Cloudflare Pages

Der Stack und warum

EbeneWahlWarum
Website-FrameworkAstroLiefert statisches HTML mit nahezu keinem JavaScript – schnell auf Smartphones, nichts zu patchen, Inhalte in Markdown mit typisiertem Frontmatter.
Content-EditorPagesCMS (app.pagescms.org)Kostenlos, Open Source, Git-basiert: Mitarbeiter bearbeiten in Webformularen; jede Speicherung ist ein Git-Commit. Keine Datenbank, kein CMS-Server zum Betreiben.
HostingCloudflare PagesDer kostenlose Tarif passt bequem für eine Praxis-Website (großzügige Build-Minuten und Bandbreite, viele benutzerdefinierte Domains), kein Branding, kommerzielle Nutzung erlaubt, globales CDN, automatisches HTTPS. Deployment = Git-Repo verbinden.
RepositoryGitHub (praxis-eigen)Die einzige Heimat der Website: Astro liest daraus, PagesCMS schreibt hinein, Cloudflare baut daraus.

Die Architekturregel, die dies ermöglicht: Die Website ist eine Publikation, keine Anwendung. Seiten, Profile und Beiträge sind Inhalte. Buchungen, Zahlungen, Nachrichten und Verzeichnisse haben bereits Systeme – die Website bettet sie ein und verlinkt sie; sie implementiert sie nie neu und empfängt nie deren Daten.

Anweisungen für den Agenten

  • Ergebnis = ein funktionierendes Repository, das der Praxis gehört + die drei Verbindungen (PagesCMS → Repo, Cloudflare Pages → Repo + Domain) + eine verifizierte Ende-zu-Ende-Bearbeitung über das CMS. Wenn Sie keinen Zugriff auf die Konten haben, erstellen Sie das vollständige Repository und eine Schritt-für-Schritt-Anleitung zur Verbindung für den Eigentümer.
  • Führen Sie zuerst das Einrichtungsinterview durch. Erfinden Sie niemals Praxis-Fakten – Qualifikationen, Lizenzen, Kassenabrechnungen, Honorare, Sprachen, Berufserfahrung. Platzhalter, gekennzeichnet, bis der Eigentümer sie liefert.
  • Überprüfen Sie jedes Plattformverhalten anhand der Live-Konfiguration, nicht aus dem Gedächtnis: Die PagesCMS-Filename-Template-Regel in references/pagescms-config.md hat einer echten Website ihren ersten Speicher-Versuch gekostet – behandeln Sie den CMS-Speichertest als Definition von „konfiguriert".

Einrichtungsinterview (einmal fragen, vor dem Bau)

  1. Praxis-Identität – Praxisname, Domain (und wo das DNS liegt – Cloudflare-Hosting ist am reibungslosesten, wenn DNS auch bei Cloudflare ist), Logo/Farben, falls vorhanden, Telefon/E-Mail zur Anzeige.
  2. Struktur – Einzelpraxis oder Gruppe; Liste der Anbieter (Namen, Berufsbezeichnungen, Lizenzstaaten, Verfügbarkeit von Fotos) für Profilseiten.
  3. Seiten – Bestätigen Sie den Bauplan in references/site-blueprint.md (hinzufügen/entfernen: z. B. eine eigene Seite pro Dienstleistung? einen Ressourcen/Blog-Bereich? ein Überweisungsverzeichnis-Einbettung?).
  4. Sprachen – eine Sprache, oder ein gespiegelter Baum (z. B. Englisch unter /, Chinesisch unter /zh/)? Gespiegelt bedeutet menschenübersetzte Seiten mit eigenen Slugs – planen Sie die Übersetzung ein; übersetzen Sie klinisch relevante Inhalte niemals maschinell und veröffentlichen Sie sie ungelesen.
  5. Dynamische Einbettungen – welche bestehenden Systeme auf der Website erscheinen (Buchungsseite, Kontaktformular-App, Überweisungsverzeichnis, Einstiegspunkt für sichere Nachrichten) und deren URLs. Diese werden iframe-Einbettungen + Fallback-Links.
  6. Redakteure – wer aktualisiert nach dem Start die Inhalte (nur der Eigentümer? eine Verwaltungskraft? Anbieter schreiben Beiträge?) – dies entscheidet über PagesCMS-Zugriff und wie viel der Website CMS-verwaltet vs. code-verwaltet ist.
  7. Vorhandene Assets – aktuelle Website-Inhalte zur Migration, Fotos (und deren Rechte), Google Business Profile und Verzeichniseinträge, mit denen die Website konsistent bleiben muss.

Harte Regeln

  1. Die Praxis besitzt jedes Konto – Domain-Registrar, GitHub, Cloudflare. Richten Sie es unter den Logins der Praxis ein, mit Wiederherstellungsoptionen, die die Praxis kontrolliert.
  2. Inhalt ist Daten, kein Code. Alles, was ein Redakteur ändern könnte (Anbieter-Bios, Dienstleistungen, Honorare, FAQs, Beiträge), lebt in Markdown/Frontmatter hinter einem Content-Schema – niemals fest in .astro-Vorlagen codiert.
  3. PagesCMS-Dateinamen-Vorlagen verwenden {fields.slug} (oder den tatsächlichen Feldpfad der Sammlung). Ein bloßes {slug} ist ungültig und führt bei jedem CMS-Speichervorgang zu einem undurchsichtigen Fehler. Nach der Korrektur der Konfiguration das CMS neu laden – es speichert die Konfiguration pro Session zwischen.
  4. Die Website sammelt nichts Klinisches. Keine Symptom-Textfelder, keine „Erzählen Sie uns, was los ist"-Formulare. Kontakt = Buchungslink/-einbettung, Telefon und ggf. eine weitergeleitete Formular-App – plus die Krisentelefonnummer (in Deutschland z. B. die Telefonseelsorge unter 0800 111 0 111 oder 0800 111 0 222, und 112 für Notfälle) auf der Kontaktseite und jeder Seite, die zur Kontaktaufnahme einlädt, in den Sprachen der Website.
  5. Einbettungen erhalten Fallback-Links. Jeder iframe (Buchung, Verzeichnis) wird mit einem einfachen Link zum selben System gepaart, sodass ein blockierter Frame nie eine Sackgasse für den Klienten darstellt.
  6. Angaben-Disziplin: Kassenabrechnungen, Honorare, Qualifikationen und Verfügbarkeit auf der Website müssen mit der Wahrheitsquelle der Praxis (ihrem Verzeichnis/ihren Aufzeichnungen) übereinstimmen. Die Website ist der letzte Ort, an dem eine Tatsache bearbeitet werden sollte – wenn eine Zahl an zwei Orten lebt, benennen Sie, welche gewinnt.
  7. Leistung ist ein Feature auf einer Therapie-Website – Menschen kommen ängstlich, auf Smartphones, von einem Verzeichnisprofil. Komprimieren Sie Bilder, bevor sie in das Repository gelangen; ein 2-MB-Heldenfoto ist ein Fehler, kein Asset.

Bau-Reihenfolge

  1. Repository + Astro-Grundgerüst + Inhaltsmodell gemäß references/astro-setup.md, Seiten gemäß references/site-blueprint.md.
  2. Lokaler Build grün; Inhaltsplatzhalter gekennzeichnet und für den Eigentümer aufgelistet.
  3. PagesCMS-Konfiguration + der echte Speichertest gemäß references/pagescms-config.md.
  4. Cloudflare Pages-Verbindung + benutzerdefinierte Domain gemäß references/cloudflare-pages-deploy.md.
  5. SEO/Leistungsdurchlauf gemäß references/seo-and-performance.md.
  6. Übergabe gemäß references/maintenance-and-handoff.md; Überprüfung gemäß references/test-checklist.md.

Referenzdateien

  • references/architecture-and-stack.md – die drei Ebenen, Datenfluss, was statisch für eine Praxis bedeutet
  • references/site-blueprint.md – die Seiten, was jede enthalten muss, therapie-spezifische Muss-Liste
  • references/astro-setup.md – Projektstruktur, Content-Collections + Schema, mehrsprachiger Baum
  • references/pagescms-config.md – .pages.yml, Collections, Medien, die Filename-Template-Regel
  • references/cloudflare-pages-deploy.md – Projekt-Setup, Build-Einstellungen, benutzerdefinierte Domain, Vorschauen
  • references/seo-and-performance.md – Metadaten, strukturierte Daten, Sitemap/RSS, llms.txt, Bilder
  • references/maintenance-and-handoff.md – Bearbeitungsworkflow, Updates, Backups, wer was besitzt
  • references/test-checklist.md – Akzeptanztests, der CMS-Speichertest zuerst

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

mindxassociates/practice-books-kit

Monthly bookkeeping and payroll for a therapy private practice (solo or group). Use when the practice owner wants to (1) turn bank and credit-card statements into a filled monthly profit-and-loss workbook using a fixed chart of accounts, with every transaction classified, internal transfers excluded, and the month tied out to the penny; and/or (2) build and deploy a companion "Practice Books" web app that runs monthly contractor/employee payroll (1099 + W-2 estimates) and shows a read-only visual dashboard of the P&L (charts, trends, category mixes). Reference implementation: Google Sheets + Google Apps Script, but the workflows are written to work with any spreadsheet/app stack the agent can drive.

mindxassociates/solo-consult-booking-kit

A HIPAA-supporting initial-consultation booking system for a SOLO therapy private practice, built on Google Workspace + Apps Script + Sheets + Calendar. Use when a solo practice owner wants (1) a public booking page where prospective clients book a free initial consultation against the owner's real calendar availability, with confirmation / reminder / follow-up emails and a private reschedule-cancel link; and (2) one private owner console to set weekly consult hours, date-specific hours and time off, view upcoming consults and mark no-shows, and edit email templates and booking rules. Adapted from a group-practice system (public Booking app + Manage Availability + My Consults + Consult Admin) — the solo edition merges the three staff apps into one console and drops the group edition's calendar-connection app entirely.

Verwandte Skills

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community