Communitygithub.com

PeakWorkflowSolutions/pws-portfolio

Génère des conventions de service, conditions de rétention et formulaires de consentement/accès aux marques PWS, prêts à imprimer, à partir du périmètre réel d'un client — un accord par version, paiement 20/80, tableau des livraisons Automation Builds remplissable avec prix totalisé automatiquement, tableaux noir et blanc, sans calcul de réduction intégré.

Qu'est-ce que pws-portfolio ?

Ce skill permet de générer automatiquement la paperasse d'intégration d'un client pour l'agence Peak Workflow Solutions (PWS), en transformant un périmètre défini en documents signables et aux couleurs de la marque. Il produit des conventions de service, des conditions de rétention avec autorisation de prélèvement automatique et un préavis de résiliation de 30 jours, ainsi qu'une autorisation d'accès et de consentement. Chaque accord est créé pour un seul projet, avec un tableau « Automation Builds » (colonne Automatisation, Description, Calendrier, Prix de la version initiale) dont le total est calculé automatiquement à partir des prix saisis. Le skill suit des règles strictes : pas de calcul de réduction, pas de chiffres inventés, section des frais récurrents séparée du paiement 20/80 unique, tableaux en noir et blanc, et vérification systématique en convertissant le document en PDF puis en images JPG. Cette approche garantit que chaque document est cohérent, précis et prêt à être présenté au client, en s'appuyant sur les entrées réelles du projet (emails, notes) plutôt que sur des informations mémorisées. Le skill est conçu pour être utilisé avec l'outil docx (génération de documents Word) et envoie le fichier final au client via SendUserFile.

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

Demander à votre IA préférée

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

Documentation

Générateur de documents clients PWS

Ceci est le processus de paperasse d'intégration du Directeur de Construction. Il transforme un engagement défini en documents signables et aux couleurs de la marque à partir du modèle maître PWS — et non à partir de modèles remplis d'instructions à soi-même. Utilisez-le depuis le projet propre du client (pas le projet général PWS) lors de la création de la paperasse réelle de ce client, afin que son périmètre réel, ses prix et ses notes soient à portée de main pendant que vous remplissez le document.

Déclencheur

  • Un nouveau client est prêt pour une convention de services (n'importe quel engagement, ponctuel ou récurrent).
  • Un client existant commence un nouveau projet distinct (un nouveau périmètre de travaux) au-delà de ce qu'il a déjà signé.
  • L'engagement d'un client nécessite une Autorisation de consentement et d'accès client correspondante (chaque fois que PWS a besoin d'accéder aux comptes/fichiers/systèmes du client).

Décisions fondamentales (à prendre avant d'écrire quoi que ce soit — ne jamais supposer)

  1. Un accord par version, pas un contrat unique géant. Regroupez les livrables dans un seul accord uniquement lorsqu'ils sont définis/livrés ensemble sur à peu près le même calendrier. Séparez-les en accords distincts lorsque les calendriers ou l'état de préparation divergent — le « 80 % dû à l'achèvement » d'un seul accord ne fonctionne proprement que lorsque tout ce qui se trouve dans son Annexe A se termine à peu près en même temps. Chaque accord autonome peut être étiqueté comme sa propre « Phase » (Phase 1, Phase 2, ...) via le champ remplissable près du haut de l'accord, idéalement dans l'ordre de priorité indiqué par le client — c'est une étiquette sur un document complet et séparément tarifé, jamais un moyen de diviser le périmètre d'un document en une partie tarifée et une partie en attente non tarifée.
  2. Structure de paiement : le travail ponctuel est un montant forfaitaire total, 20 % dû à la signature / 80 % dû à l'achèvement. La section Honoraires et Paiement N'imprime PAS ses propres montants en dollars — elle fait référence au Prix Total de la Version Initiale de l'Annexe A comme source unique de vérité (« le montant total des honoraires pour le Périmètre de Travaux est le Prix Total de la Version Initiale indiqué dans l'Annexe A »). Le travail récurrent/de rétention n'est jamais intégré dans cette répartition 20/80 — il figure dans sa propre section « Services récurrents, prélèvement automatique et annulation » avec autorisation de prélèvement automatique et un préavis de résiliation écrit de 30 jours requis, facturé mensuellement.
  3. N'imprimez jamais de calculs de réduction. Pas de comparaison de tarifs standard, pas de « vous économisez X % », pas de mention de « tarif premier client » dans le document lui-même. Marcos présente toute réduction verbalement lorsqu'il présente l'offre. Le document indique simplement les honoraires. Les demandes de témoignage/droits de revente (si utilisées) sont indépendantes, jamais présentées comme un échange contre une réduction.
  4. N'inventez jamais de chiffres. Montants des honoraires, dates cibles, heures incluses par mois, délais de réponse — si Marcos n'a pas donné de chiffre réel, laissez-le comme une ligne de remplissage vierge, jamais une estimation. Extrayez le langage réel du périmètre des emails/notes du client lorsqu'il est disponible — ne paraphrasez pas de mémoire si l'original est accessible (vérifiez Gmail/Notion pour cela).
  5. Contenu de la rétention, le cas échéant : ce qui est inclus (surveillance, correctifs pour les pannes causées par des modifications des plateformes connectées, une allocation mensuelle maximale d'heures/réglages), un engagement de délai de réponse, une autorisation de prélèvement automatique et le préavis d'annulation de 30 jours. Tarification de départ suggérée pour conseiller Marcos (pas à imprimer) : environ 150 à 250 $/mois pour la surveillance uniquement, jusqu'à environ 350 à 500 $/mois si cela inclut un travail actif comme le réglage des canaux de génération de leads — toujours bien en dessous du signal de sensibilité au prix que le client a déjà donné.

Processus de création

  1. Recueillez les entrées réelles. Nom légal/nom commercial du client, date d'effet (ou blanc), les éléments réels du périmètre (à partir de ses emails/notes, pas paraphrasés de mémoire), si chaque élément est ponctuel ou récurrent, et tout prix que Marcos a réellement décidé. Demandez-lui directement tout ce qui n'est pas encore décidé plutôt que de deviner.
  2. Utilisez le module de marque partagé (reconstruisez-le si cet environnement ne l'a pas — il est court, reproduisez-le à partir de l'extrait ci-dessous dans brand.js avec une copie recadrée du logo PWS) :
const BRAND = {
 navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
 bodyFont: "Times New Roman", // police à empattement universelle professionnelle/pour documents juridiques
 headingFont: "Poppins", // police géométrique sans empattement en gras, écho au mot-symbole PEAK
};
function docStyles() {
 return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText) : image du logo + titre en bleu marine et gras (police : BRAND.headingFont) sous une règle orange
// footer() : centré « Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com », petit, gris, règle bleue en haut
// h1(text) / h2(text) : titres en bleu marine et gras, police : BRAND.headingFont

Étalez ...docStyles() dans chaque appel new Document({...}) afin que le texte du corps utilise par défaut Times New Roman ; les titres/en-tête de lettre remplacent explicitement par Poppins Bold.

  1. Les en-têtes de tableau sont en noir et blanc, jamais avec un fond de couleur. Une version antérieure avait des cellules d'en-tête ombrées en bleu marine — le texte d'en-tête n'avait pas de couleur explicite définie, il s'affichait donc en noir sur bleu marine, avec un contraste vraiment faible sur certains écrans. Les en-têtes de tableau sont simplement du texte noir en gras sur fond blanc avec des bordures de quadrillage simples. Ne réintroduisez pas de couleur de shade/remplissage dans les cellules d'en-tête.

  2. Lignes de remplissage vierges : utilisez un blanc court dans les cellules du tableau. La ligne de remplissage vierge standard (U = "________________", 16 tirets bas) est destinée au texte du corps et aux cellules larges. Dans les cellules de tableau plus étroites (une colonne Calendrier, une cellule de prix de ligne Total), elle passe à la ligne suivante et semble cassée — utilisez plutôt un blanc plus court (US = "__________", 10 tirets bas).

  3. Flux de sections standard (docx-js via la compétence docx) : bloc d'ouverture/parties, puis une ligne « Phase ___ — ___ (nom de l'engagement) » ; Services et Périmètre de Travaux ; Durée ; Honoraires et Paiement (clauses numérotées : Honoraires [fait référence au Total de l'Annexe A, pas d'espace dollar séparé], Échéancier de paiement [20/80, pas d'espaces dollar séparés], Le périmètre supplémentaire donne lieu à un nouvel accord, Facturation, Paiement en retard) ; [Services récurrents, prélèvement automatique et annulation — uniquement si cet engagement a un volet de rétention] ; Responsabilités du client ; Accès aux systèmes et données du client ; Propriété intellectuelle et droits de revente (Sorties spécifiques au client, Outils du fournisseur, Témoignage, Droits de revente) ; Confidentialité ; Garantie et exclusion de responsabilité ; Limitation de responsabilité ; Sous-traitant indépendant ; Résiliation ; Droit applicable ; Intégralité de l'accord et modifications ; saut de page ; Annexe A ; Signatures.

  4. Structure de l'Annexe A — utilisez toujours cette forme :

    • Tableau « Automation Builds » : colonnes Automatisation | Description | Calendrier | Prix de la version initiale. Une ligne par automatisation/livrable distinct dans cet engagement — un projet de 20 lignes a 20 lignes, un projet de 2 lignes a 2 lignes. Lorsque Marcos donne des lignes réelles (nom, description, calendrier, prix), remplissez chaque ligne directement plutôt que de laisser des blancs. Terminez par une ligne de bas, les trois premières colonnes fusionnées (columnSpan: 3) indiquant « Prix Total de la Version Initiale », la dernière colonne contenant le total en dollars — additionnez vous-même les prix saisis par ligne plutôt que de laisser un blanc lorsque chaque ligne a un prix réel ; laissez une ligne de remplissage vierge uniquement si un ou plusieurs postes n'ont pas encore de prix décidé.
    • Section « Rétention / Maintenance mensuelle » immédiatement en dessous, son propre petit tableau avec seulement trois colonnes — Fréquence | Honoraires | Prélèvement automatique (pas de colonne « Service » ; Marcos a trouvé peu clair ce qui irait là lorsque l'engagement n'a qu'une seule ligne de rétention) — « Mensuel » pré-rempli dans Fréquence, une case à cocher ☐ Autorisé (Section 4.3) dans Prélèvement automatique. Incluez ce tableau uniquement si l'engagement a une composante récurrente ; sinon, indiquez clairement « Aucun service de maintenance ou de rétention récurrent ne s'applique à cet engagement. » plutôt que de supprimer la section (cela permet de garder la même forme pour chaque Annexe A).
  5. Pièges de numérotation (spécifiques à docx-js, déjà rencontrés deux fois — ne pas répéter) :

    • Une chaîne numbering.reference compte en continu sur l'ENSEMBLE du document si elle est réutilisée entre les sections. Donnez à chaque bloc de clause numérotée logique (Honoraires, Récurrent, PI) son propre nom de référence (par exemple clausesFees, clausesRecurring, clausesIP), jamais une référence "clauses" partagée.
    • Lorsque la liste des sections d'un document varie (par exemple section Récurrent présente ou absente), ne tapez pas manuellement le texte « Section 4 » / « Section 12 » — cela dérive dès que des sections sont ajoutées ou supprimées. Précalculez un tableau ordonné de clés de section, associez chaque clé à son numéro une fois, et interpolez ce numéro dans les références croisées. Voir le modèle : construisez sectionOrder (en incluant conditionnellement « recurring »), puis secNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1), puis référencez secNum.termination etc. partout où un numéro de section est mentionné dans le texte du corps.
    • TableCell a besoin d'une option columnSpan transmise via votre fonction d'aide cell() pour construire la ligne Total fusionnée — n'oubliez pas de l'ajouter si vous réutilisez une ancienne fonction cell() qui ne gère que width/shade.
  6. Créez l'Autorisation de consentement et d'accès correspondante pour tout engagement qui touche à de nouveaux systèmes — ne réutilisez pas les lignes du tableau d'accès d'un ancien engagement pour une version différente. Même image de marque, même motif de tableau remplissable noir et blanc (Système/Compte, Élément spécifique, Accès accordé, Objet).

  7. Vérifiez avant de livrer — à chaque fois : convertissez en PDF (le script soffice.py --headless --convert-to pdf de la compétence docx), rendezez en JPG (pdftoppm -jpeg -r 100), et lisez (Read) chaque image de page pour confirmer : image de marque correcte, numéros de section séquentiels et références croisées cohérentes, aucun langage de réduction/tarif standard infiltré, les blancs sont vraiment vierges (pas de chiffres obsolètes d'un client précédent), pas de saut de ligne disgracieux sur les blancs courts, et le total de l'Automation Builds est bien égal à la somme de ses lignes. Ne livrez jamais une reconstruction sans revérifier.

  8. Livrez via SendUserFile, et consignez ce qui a été construit + toutes les décisions de prix/structure dans le journal de construction du projet propre du client, et non pas dans le projet général PWS.

Vérification

  • Aucun montant en dollars, date ou nombre d'heures n'apparaît dans le document à moins que Marcos ne l'ait explicitement fourni
  • Aucun calcul de réduction, pourcentage d'économie ou mention de « tarif premier client » nulle part
  • Chaque service récurrent est sous sa propre Section (prélèvement automatique + annulation 30 jours), jamais à l'intérieur de la répartition 20/80 unique
  • Les numéros de section ont été lus à partir du PDF réel rendu, pas supposés à partir du code
  • Le Prix Total de la Version Initiale de l'Annexe A est égal à la somme des lignes remplies
  • La section Honoraires et Paiement fait référence au total de l'Annexe A plutôt que d'imprimer son propre espace dollar séparé
  • Les en-têtes de tableau sont du texte noir en gras sur fond blanc — aucun ombrage de couleur nulle part
  • Le tableau de rétention a exactement trois colonnes (Fréquence | Honoraires | Prélèvement automatique), pas de colonne Service
  • L'image de marque (logo, bleu marine/bleu/orange, corps Times New Roman / titres Poppins Bold, pied de page) correspond sur chaque page
  • Un rappel a été fait qu'un avocat agréé de l'État de Washington devrait examiner le document avant que tout client ne le signe

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.

Skills associés