Communitygithub.com

PWS Client Paperwork Generator

Erstellt markierte, druckfertige PWS-Dienstleistungsvereinbarungen, Retainer-Bedingungen und Zustimmungs-/Zugriffsformulare basierend auf dem tatsächlichen Umfang eines Kunden – eine Vereinbarung pro Build, 20/80-Zahlung, ausfüllbare Tabelle für Automatisierungs-Builds mit automatisch summierter Preisangabe, schwarz-weiße Tabellen, keine integrierte Rabattmathematik.

Was ist PWS Client Paperwork Generator?

Dieses Skill generiert professionelle, markenrechtlich geschützte Kundenunterlagen für Peak Workflow Solutions (PWS). Es erstellt Dienstleistungsvereinbarungen, Retainer-Bedingungen und Zustimmungs-/Zugriffsformulare, die auf den tatsächlichen Umfang eines Engagements zugeschnitten sind. Die Dokumente werden als DOCX-Dateien mit PWS-Branding (Navy, Blau, Orange) erstellt und enthalten eine klare 20/80-Zahlungsstruktur, eine ausfüllbare Tabelle für Automatisierungs-Builds mit automatisch summierter Preisangabe und schwarz-weiße Tabellen ohne Farbschattierung. Das Skill stellt sicher, dass keine Rabattberechnungen, Standardpreisvergleiche oder erfundenen Zahlen in den Dokumenten erscheinen. Es unterstützt Plattformen wie Claude Code, Cursor und Codex und basiert auf einem modularen Ansatz mit einer gemeinsamen Branding-Datei (brand.js) und dem docx-Skill zur Erstellung der Dokumente. Der Prozess umfasst das Sammeln echter Eingaben (z.B. aus E-Mails oder Notizen), die Verwendung einer standardisierten Abschnittsstruktur, die Vermeidung von Nummerierungsfehlern in docx-js und eine gründliche Überprüfung der generierten PDFs vor der Auslieferung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PeakWorkflowSolutions/pws-portfolio/tree/HEAD/skills/pws-client-paperwork

In Ihrer bevorzugten KI fragen

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

Dokumentation

PWS-Client-Papierkram-Generator

Dies ist der Onboarding-Papierkram-Prozess des Bauleiters. Er verwandelt ein abgegrenztes Engagement in unterzeichnungsfähige, markierte Dokumente aus der PWS-Mastervorlage – nicht in Vorlagen voller Anweisungen an einen selbst. Verwenden Sie dies von einem eigenen Projekt des Kunden (nicht dem allgemeinen PWS-Projekt), wenn Sie die tatsächlichen Unterlagen dieses Kunden erstellen, sodass dessen tatsächlicher Umfang, Preisgestaltung und Notizen während des Ausfüllens verfügbar sind.

Auslöser

  • Ein neuer Kunde ist bereit für eine Dienstleistungsvereinbarung (jedes Engagement, einmalig oder wiederkehrend).
  • Ein bestehender Kunde beginnt einen neuen, eigenständigen Build (einen neuen SOW), der über das bereits Unterzeichnete hinausgeht.
  • Für das Engagement eines Kunden wird eine entsprechende Client Consent & Access Authorization benötigt (immer wenn PWS Zugriff auf die eigenen Konten/Dateien/Systeme des Kunden benötigt).

Kernentscheidungen (treffen Sie diese, bevor Sie etwas schreiben – niemals annehmen)

  1. Eine Vereinbarung pro Build, nicht ein riesiger Vertrag. Bündeln Sie Liefergegenstände nur dann in einer Vereinbarung, wenn sie gemeinsam abgegrenzt/geliefert werden und ungefähr denselben Zeitplan haben. Teilen Sie sie in separate Vereinbarungen auf, wenn die Zeitpläne oder die Bereitschaft auseinandergehen – die „80 % bei Fertigstellung“-Regelung einer einzelnen Vereinbarung funktioniert nur sauber, wenn alles in Anlage A ungefähr zur gleichen Zeit fertig wird. Jede eigenständige Vereinbarung kann über das ausfüllbare Feld oben in der Vereinbarung als eigene „Phase“ (Phase 1, Phase 2, ...) bezeichnet werden, idealerweise in der vom Kunden selbst angegebenen Prioritätsreihenfolge – das ist eine Bezeichnung auf einem vollständigen, separat bepreisten Dokument, niemals eine Möglichkeit, den Umfang eines Dokuments in einen bepreisten und einen unbepreisten, ausstehenden Teil aufzuteilen.
  2. Zahlungsstruktur: Einmalige Arbeit ist eine Pauschalgebühr, 20 % bei Unterzeichnung / 80 % bei Fertigstellung fällig. Der Abschnitt „Gebühren und Zahlung“ druckt KEINE eigenen Zahlen – er verweist auf den Gesamtpreis des initialen Builds in Anlage A als einzige Quelle der Wahrheit („Die Gesamtgebühr für den Leistungsumfang ist der Gesamtpreis des initialen Builds, wie in Anlage A angegeben“). Wiederkehrende/Retainer-Arbeiten werden niemals in diese 20/80-Aufteilung einbezogen – sie leben in einem eigenen Abschnitt „Wiederkehrende Dienste, automatische Zahlung und Kündigung“ mit Autopay-Autorisierung und einer erforderlichen 30-tägigen schriftlichen Kündigungsfrist, monatlich abgerechnet.
  3. Niemals Rabattmathematik drucken. Keine Standardpreisvergleiche, keine „Sie sparen X %“, keine „Erstkundenpreis“-Rahmung im Dokument selbst. Marcos präsentiert Rabatte mündlich, wenn er das Angebot vorlegt. Das Dokument gibt lediglich die Gebühr an. Anfragen zu Testimonials/Wiederverkaufsrechten (falls verwendet) stehen für sich allein, nicht als Gegenleistung für einen Rabatt dargestellt.
  4. Niemals Zahlen erfinden. Gebührenbeträge, Zieltermine, enthaltene Stunden pro Monat, Reaktionszeiten – wenn Marcos keine tatsächliche Zahl genannt hat, lassen Sie es als leere Ausfüllzeile, niemals als Schätzung. Entnehmen Sie tatsächliche Formulierungen aus den E-Mails/Notizen des Kunden, wenn verfügbar – paraphrasieren Sie nicht aus dem Gedächtnis, wenn das Original erreichbar ist (überprüfen Sie Gmail/Notion dafür).
  5. Retainer-Inhalt, falls zutreffend: Was enthalten ist (Überwachung, Fehlerbehebungen bei durch Änderungen an verbundenen Plattformen verursachten Problemen, eine gedeckelte monatliche Stunden-/Optimierungszulage), eine Reaktionszeitverpflichtung, Autopay-Autorisierung und die 30-tägige Kündigungsfrist. Vorgeschlagene Startpreise zur Beratung von Marcos (nicht zum Drucken): ~150–250 $/Monat für reine Überwachung, bis zu ~350–500 $/Monat, wenn es aktive Arbeit wie die Optimierung von Lead-Generierungskanälen beinhaltet – immer deutlich unter dem Preissensibilitätssignal, das der Kunde bereits gegeben hat.

Erstellungsprozess

  1. Sammeln Sie echte Eingaben. Rechts-/Handelsname des Kunden, Wirksamkeitsdatum (oder leer), die tatsächlichen Umfangspunkte (aus dessen E-Mails/Notizen, nicht aus dem Gedächtnis paraphrasiert), ob jeder Punkt einmalig oder wiederkehrend ist, und alle Preise, die Marcos tatsächlich festgelegt hat. Fragen Sie ihn direkt nach allem, was noch nicht entschieden ist, anstatt zu raten.
  2. Verwenden Sie das gemeinsame Markenmodul (neu erstellen, falls diese Umgebung es nicht hat – es ist kurz, reproduzieren Sie es aus dem folgenden Ausschnitt in brand.js zusammen mit einer zugeschnittenen Kopie des PWS-Logos):
const BRAND = {
 navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
 bodyFont: "Times New Roman", // universelle professionelle/rechtliche Serifenschrift
 headingFont: "Poppins", // fette geometrische Sans, spiegelt das PEAK-Wortmarke wider
};
function docStyles() {
 return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText): Logo-Bild + fette navy-Überschrift (Schriftart: BRAND.headingFont) unter einem orangefarbenen Strich
// footer(): zentriert "Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com", klein, grau, blauer oberer Strich
// h1(text) / h2(text): fette navy-Überschriften, Schriftart: BRAND.headingFont

Verteilen Sie ...docStyles() in jeden new Document({...})-Aufruf, sodass der Fließtext standardmäßig in Times New Roman gesetzt wird; Überschriften/Briefkopf überschreiben explizit mit Poppins Bold.

  1. Tabellenüberschriften sind schwarz-weiß, niemals farbig schattiert. Eine frühere Version schattierte Kopfzellen in Navy – der Kopftext hatte keine explizite Farbe gesetzt, sodass er auf einigen Bildschirmen als schwarz-auf-navy, ehrlich gesagt mit geringem Kontrast, dargestellt wurde. Tabellenüberschriften sind einfach fetter schwarzer Text auf Weiß mit einfachen Gitterlinienrändern. Führen Sie keine shade/Füllfarbe für Kopfzellen wieder ein.

  2. Leere Ausfüllzeilen: Verwenden Sie eine kurze Leerzeile innerhalb von Tabellenzellen. Die Standard-Ausfüllzeile (U = "________________", 16 Unterstriche) ist für Fließtext und breite Zellen. In engeren Tabellenzellen (einer Zeitplanspalte, einer Preiszeile für die Gesamtsumme) bricht sie in eine zweite Zeile um und sieht kaputt aus – verwenden Sie stattdessen dort eine kürzere Leerzeile (US = "__________", 10 Unterstriche).

  3. Standard-Abschnittsfluss (docx-js über das docx-Skill): Eröffnungs-/Parteienblock, dann eine ausfüllbare Zeile „Phase ___ — ___ (Engagement-Name)“; Dienstleistungen und Leistungsumfang; Laufzeit; Gebühren und Zahlung (nummerierte Klauseln: Gebühr [verweist auf Anlage A Gesamtsumme, kein separates Dollarfeld], Zahlungsplan [20/80, keine separaten Dollarfelder], Zusätzlicher Umfang führt zu einer neuen Vereinbarung, Rechnungsstellung, Zahlungsverzug); [Wiederkehrende Dienste, automatische Zahlung und Kündigung – nur wenn dieses Engagement eine Retainer-Komponente hat]; Verantwortlichkeiten des Kunden; Zugang zu Kundensystemen und -daten; Geistiges Eigentum und Wiederverkaufsrechte (Kundenspezifische Ergebnisse, Anbieterwerkzeuge, Testimonial, Wiederverkaufsrechte); Vertraulichkeit; Gewährleistung und Haftungsausschluss; Haftungsbeschränkung; Selbstständiger; Kündigung; Geltendes Recht; Gesamtvereinbarung und Änderungen; Seitenumbruch; Anlage A; Unterschriften.

  4. Anlage A-Struktur – verwenden Sie immer diese Form:

    • Tabelle „Automatisierungs-Builds“: Spalten Automatisierung | Beschreibung | Zeitplan | Initialer Build-Preis. Eine Zeile pro eindeutiger Automatisierung/Liefergegenstand in diesem Engagement – ein 20-zeiliges Projekt erhält 20 Zeilen, ein 2-zeiliges Projekt erhält 2. Wenn Marcos tatsächliche Einzelposten (Name, Beschreibung, Zeitplan, Preis) angibt, füllen Sie jede Zeile direkt aus, anstatt sie leer zu lassen. Enden Sie mit einer unteren Zeile, die ersten drei Spalten zusammengeführt (columnSpan: 3) mit dem Text „Gesamter initialer Build-Preis“, die letzte Spalte enthält den Dollar-Gesamtbetrag – summieren Sie die eingegebenen Preise pro Zeile selbst, anstatt sie leer zu lassen, wenn jeder Einzelposten einen tatsächlichen Preis hat; lassen Sie sie nur dann als leere Ausfüllzeile, wenn einer oder mehrere Einzelposten noch keinen festgelegten Preis haben.
    • Abschnitt „Monatlicher Retainer / Wartung“ direkt darunter, eigene kleine Tabelle mit nur drei Spalten – Häufigkeit | Gebühr | Autopay (keine Spalte „Dienstleistung“; Marcos fand es unklar, was dort hinkäme, wenn das Engagement nur eine Retainer-Zeile hat) – „Monatlich“ vorausgefüllt in Häufigkeit, ein Kontrollkästchen ☐ Autorisiert (Abschnitt 4.3) in Autopay. Fügen Sie diese Tabelle nur ein, wenn das Engagement eine wiederkehrende Komponente hat; andernfalls geben Sie klar an: „Für dieses Engagement gelten keine wiederkehrenden Wartungs- oder Retainer-Dienste.“, anstatt den Abschnitt zu löschen (damit jede Anlage A die gleiche Form behält).
  5. Nummerierungsfallen (docx-js-spezifisch, bereits zweimal aufgetreten – nicht wiederholen):

    • Eine numbering.reference-Zeichenfolge zählt über das GESAMTE Dokument kontinuierlich, wenn sie über Abschnitte hinweg wiederverwendet wird. Geben Sie jedem logischen nummerierten Klauselblock (Gebühren, Wiederkehrend, IP) einen eigenen Referenznamen (z.B. clausesFees, clausesRecurring, clausesIP), niemals eine gemeinsame Referenz "clauses".
    • Wenn die Abschnittsliste eines Dokuments variiert (z.B. Abschnitt „Wiederkehrend“ vorhanden oder nicht), geben Sie „Abschnitt 4“ / „Abschnitt 12“-Text nicht von Hand ein – dieser driftet, sobald Abschnitte hinzugefügt oder entfernt werden. Berechnen Sie vorab ein geordnetes Array von Abschnittsschlüsseln, mappen Sie jeden auf seine Nummer einmal und interpolieren Sie diese Nummer in Querverweise. Siehe das Muster: erstellen Sie sectionOrder (bedingt einschließlich "recurring"), dann secNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1), dann referenzieren Sie secNum.termination usw., wo immer eine Abschnittsnummer im Fließtext erwähnt wird.
    • TableCell benötigt eine columnSpan-Option, die durch Ihren cell()-Helper gefädelt werden muss, um die zusammengeführte Gesamtzeile zu erstellen – vergessen Sie nicht, sie hinzuzufügen, wenn Sie einen älteren cell()-Helper wiederverwenden, der nur width/shade verarbeitet.
  6. Erstellen Sie die passende Consent & Access Authorization für jedes Engagement, das neue Systeme berührt – verwenden Sie keine Zugangstabellenzeilen eines alten Engagements für einen anderen Build wieder. Gleiches Branding, gleiches schwarz-weißes ausfüllbares Tabellenmuster (System/Konto, Spezifischer Punkt, Zugriff gewährt, Zweck).

  7. Vor der Auslieferung überprüfen – jedes Mal: in PDF konvertieren (soffice.py --headless --convert-to pdf-Skript des docx-Skills), in JPG rendern (pdftoppm -jpeg -r 100) und tatsächlich jede Seite Readen, um zu bestätigen: korrektes Branding, Abschnittsnummern sind fortlaufend und Querverweise stimmen überein, keine Rabatt-/Standardpreissprache eingeschlichen, Leerfelder sind wirklich leer (keine veralteten Zahlen von einem vorherigen Kunden), kein hässlicher Zeilenumbruch bei kurzen Leerfeldern, und die Gesamtsumme der Automatisierungs-Builds entspricht tatsächlich der Summe ihrer Zeilen. Liefern Sie niemals eine Neuerstellung ohne erneute Überprüfung aus.

  8. Auslieferung über SendUserFile, und protokollieren Sie, was erstellt wurde + alle Preis-/Strukturentscheidungen im eigenen Projekt/Build-Log dieses Kunden, nicht im allgemeinen PWS-Projekt.

Überprüfung

  • Kein Dollarbetrag, Datum oder Stundenanzahl erscheint im Dokument, es sei denn, Marcos hat es explizit angegeben
  • Keine Rabattmathematik, Sparprozentsätze oder „Erstkundenpreis“-Sprache an irgendeiner Stelle
  • Jeder wiederkehrende Dienst fällt unter seinen eigenen Abschnitt (Autopay + 30-tägige Kündigung), niemals innerhalb der einmaligen 20/80-Aufteilung
  • Abschnittsnummern wurden aus dem tatsächlich gerenderten PDF abgelesen, nicht aus dem Code angenommen
  • Anlage A Gesamter initialer Build-Preis entspricht der Summe seiner ausgefüllten Einzelposten
  • Abschnitt „Gebühren und Zahlung“ verweist auf die Gesamtsumme von Anlage A, anstatt ein eigenes separates Dollarfeld zu drucken
  • Tabellenüberschriften sind fetter schwarzer Text auf Weiß – keine Farbschattierung irgendwo
  • Retainer-Tabelle hat genau drei Spalten (Häufigkeit | Gebühr | Autopay), keine Spalte „Dienstleistung“
  • Branding (Logo, navy/blau/orange, Times New Roman Fließtext / Poppins Bold Überschriften, Fußzeile) stimmt auf jeder Seite überein
  • Es wurde eine Erinnerung gegeben, dass ein lizenzierter WA-Anwalt die Unterlagen prüfen sollte, bevor sie ein Kunde tatsächlich unterschreibt

Individual skills in this repo

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

PeakWorkflowSolutions/pws-portfolio

Runs an AI Assistant Discoverability Audit (GEO/AEO) for a local service business — crawler access, llms.txt, content extractability, answer-shaped content, schema.org, NAP consistency, and live citation testing — output as a findings table + prioritized action list.

PeakWorkflowSolutions/pws-portfolio

Generates client-ready contractor bids that reproduce a specific business's own template and voice exactly, changing only the job-specific content (scope, price, materials, timeline, client info). Use this skill whenever building, adapting, or troubleshooting a bid/proposal generator for a contractor business, whenever the user mentions "bid generator," "proposal generator," extracting a business's bid style, or onboarding a new contractor client for PWS's bid generation offer. Status: Complete (v1).

PeakWorkflowSolutions/pws-portfolio

Turns a new client's intake answers into a complete, ready-to-deploy PWS lead capture system package — Zap configs, the customized Claude prompt, Google Form fields, Sheet columns, and an owner's one-pager guide, all generated together from one intake conversation. Use this skill whenever onboarding a new client for PWS's missed-call lead capture system, whenever the user mentions "new client," "onboarding," "intake," or wants to set up the lead capture system for a specific business. This skill builds directly on top of lead-capture-skill — read that skill first if it's available, since this skill reuses its finalized prompt structure and system design.

PeakWorkflowSolutions/pws-portfolio

Scans top-performing content in a specific person's industry and local market, then builds a content playbook and tailored post ideas for lead generation. Use for Marcos's own content or any client's team/agents.

PeakWorkflowSolutions/pws-portfolio

Documents PWS's AI-Powered Missed Call Lead Capture System — an OpenPhone + Zapier + Claude + Google Forms/Sheets workflow that turns missed calls into captured leads automatically. Use this skill whenever building, adapting, explaining, or troubleshooting a missed-call lead capture system for a client, whenever the user mentions OpenPhone, Zapier lead capture, missed call automation, or a new client onboarding for PWS's flagship offer.

PeakWorkflowSolutions/pws-portfolio

Acts as Marcos's technical co-builder for a real PWS client automation project: diagnoses the client's actual problem, designs the solution and tool stack, and walks through building the workflow, scripts, or code step by step.

PeakWorkflowSolutions/pws-portfolio

Use when Marcos reports how a sales call went (in any wording, any time of day) so the lead's record in the Notion Prospects database gets updated.

PeakWorkflowSolutions/pws-portfolio

Use before Marcos's daily cold calls: pulls today's due leads from the Notion Prospects database and builds a researched, honest call script for each.

PeakWorkflowSolutions/pws-portfolio

Turns a recorded client meeting into a structured intake ready for the paperwork skill — pulls the Wispr Flow transcript, checks it against a fixed Scope/Timeline/Pricing/Payment/Access checklist, and publishes an interactive artifact so Marcos can fill in whatever the meeting didn't cover before it ends.

PeakWorkflowSolutions/pws-portfolio

Turns a new PWS video script/transcript into a ready-to-post batch of platform-specific social copy — the established priority channel set, brand voice, and per-platform formatting rules baked in.

PeakWorkflowSolutions/pws-portfolio

Runs the structured intake-to-demo pattern for a PWS website-build client: a fixed discovery questionnaire, a completeness check, and an auto-drafted first demo site built from the client's real answers with honest placeholders.

Verwandte Skills