Communitygithub.com

PeakWorkflowSolutions/pws-portfolio

Génère des devis d'entrepreneur prêts à être envoyés aux clients, en reproduisant exactement le modèle et la voix d'une entreprise spécifique, en ne modifiant que le contenu propre au projet (périmètre, prix, matériaux, calendrier, informations client). Utilisez cette compétence lors de la construction, de l'adaptation ou du dépannage d'un générateur de devis/proposition pour une entreprise d'artisan, lorsque l'utilisateur mentionne « générateur de devis », « générateur de propositions », l'extraction du style de devis d'une entreprise, ou l'intégration d'un nouveau client artisan pour l'offre de génération de devis de PWS. Statut : Terminé (v1).

Qu'est-ce que pws-portfolio ?

Cette compétence (skill) permet de générer des devis d'entrepreneur professionnels qui reproduisent fidèlement le modèle et le style d'une entreprise spécifique. Elle est conçue pour être utilisée lors de la création, de l'adaptation ou du débogage d'un générateur de devis/proposition pour un artisan. La compétence fonctionne en deux étapes : d'abord, l'extraction du style (une fois par entreprise cliente) pour capturer à la fois la voix et le modèle littéral de ses devis existants ; ensuite, la génération du devis (pour chaque nouveau projet) en combinant le profil de style et les détails du projet. Les décisions de conception clés incluent que le résultat doit être un modèle final, pas un texte brut, que la compétence n'invente jamais de faits, et que les mentions légales sont signalées, pas réécrites. L'architecture de livraison prévoit que l'entreprise cliente n'interagisse jamais directement avec Claude, mais via un pipeline automatisé (Formulaire Google → Zapier → API Claude).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PeakWorkflowSolutions/pws-portfolio/tree/HEAD/skills/bid-generator-skill

Demander à votre IA préférée

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

Documentation

Compétence Générateur de Devis — Système de Génération de Devis pour Entrepreneurs

Statut : Terminé (v1)

Les éléments sous Décisions de Conception ci-dessous sont des points de calibration par client traités lors de l'intégration, pas des obstacles.

Présentation du Système

Ce système prend les devis existants d'une entreprise d'artisan et les détails d'un nouveau projet, et produit un nouveau devis qui est visuellement et structurellement identique à leur modèle existant — même mise en page, mêmes en-têtes, même formatage, même image de marque — avec seulement le contenu spécifique au projet échangé. Il ne s'agit explicitement PAS d'un brouillon en texte brut que l'artisan reformate ; le résultat doit être la pièce finale, littérale, prête à être envoyée.

Deux couches :

  1. Extraction du style (effectuée une fois par entreprise d'artisan, à partir d'échantillons de devis) — capture à la fois leur voix (ton, formulations, densité des détails) et leur modèle littéral (mise en page, ordre des sections, formatage, image de marque). Voir references/style-extraction-guide.md.
  2. Génération du devis (effectuée pour chaque nouveau projet) — prend le profil de style/modèle ainsi qu'un formulaire de projet et produit le devis final. Voir references/generation-workflow.md.

Décisions de conception non négociables (ne pas dévier sans confirmation de l'utilisateur)

  • Résultat = modèle final, pas texte brut. La mise en page, les en-têtes et le formatage de l'artisan doivent être reproduits exactement, à chaque fois. Seuls les champs de contenu changent par devis.
  • N'inventez jamais de faits. Le périmètre, les prix, les matériaux et le calendrier proviennent uniquement de ce que l'utilisateur/l'artisan fournit pour ce projet spécifique. La compétence peut emprunter la voix et la structure du profil de style, mais ne fabrique jamais de détails de projet pour combler un manque.
  • Responsabilité de l'artisan, pas pilotage automatique. Chaque devis généré est un brouillon en attente de la propre révision et révision de l'artisan avant d'être envoyé à un client. Il ne s'agit pas de quelque chose que la compétence envoie au nom de l'artisan. Voir references/review-checkpoint.md.
  • Le langage juridique/garantie est signalé, pas réécrit. Voir references/legal-guardrail.md — c'est une politique ferme, pas un choix de style.
  • Le versionnage utilise une référence avant/après, pas l'extraction de règles. Voir references/versioning-approach.md.

Lors de la Construction d'un Nouveau Générateur de Devis Client

  1. Lisez references/bid-anatomy-residential-remodeling.md en premier — c'est le squelette recherché et standard de l'industrie de ce qu'un devis complet de rénovation résidentielle contient (page de couverture, périmètre, prix, calendrier, échéancier de paiement, conditions/section juridique, etc.). Utilisez-le comme base de comparaison : là où les échantillons réels de l'artisan correspondent, c'est une confirmation ; là où ils divergent, c'est un choix de voix d'entreprise à capturer dans leur profil, pas une erreur à corriger.
  2. Lisez references/style-extraction-guide.md et travaillez dessus avec 2 à 3+ échantillons de devis réels de l'artisan pour construire leur profil de style/modèle.
  3. Lisez references/legal-guardrail.md avant de générer tout devis contenant un langage relatif à la garantie, la responsabilité, l'indemnisation, les licences/cautionnement, ou les litiges de paiement.
  4. Lisez references/generation-workflow.md pour les étapes de collecte et de génération par devis.
  5. Lisez references/versioning-approach.md une fois que l'artisan a renvoyé des versions révisées d'au moins un devis généré — c'est ainsi que le générateur s'améliore au fil du temps.
  6. Lisez references/review-checkpoint.md pour voir comment le marqueur « en attente de révision » doit apparaître sur chaque résultat.

Architecture de Livraison (comment l'entreprise cliente utilise réellement cela)

Décidé : l'artisan n'interagit jamais directement avec Claude et n'a jamais accès à la compétence/projet. L'accès aux instructions de la compétence est la propriété intellectuelle de l'opérateur (Marcos) et reste uniquement sur le compte de l'opérateur.

Pipeline : Formulaire Google (lien privé, donne l'impression d'être l'outil propre de l'artisan) → Zapier → Appel API Claude utilisant les instructions de cette compétence → proposition finale livrée automatiquement en retour (email ou dossier Drive partagé). Aucune étape manuelle requise de la part de l'opérateur une fois construit. Cela reflète la forme Formulaire → Zapier → Claude → livraison déjà utilisée dans lead-capture-skill — même modèle, appliqué à la génération de devis au lieu de la capture de leads.

C'est pourquoi les revenus récurrents tiennent : le client paie pour un pipeline qu'il ne peut pas voir et ne possède pas, pas pour un outil qu'il pourrait reconstruire lui-même.

Futur / Pas Encore dans le Périmètre (v2+)

  • Recherche automatisée des prix des matériaux. Une idée étudiée, délibérément reportée : l'artisan soumet une liste simple de matériaux (article + quantité, éventuellement fournisseur préféré), un agent recherche les prix actuels auprès d'un site de détaillant/fournisseur spécifié, et les résultats tarifés alimentent directement l'étape de génération — pas de construction manuelle de feuille de calcul ou de nouvelle soumission. Vrais problèmes à traiter lorsque cela sera défini : les sites des détaillants varient dans leur degré d'automatisation, la précision de la correspondance des produits n'est pas garantie, et le résultat des prix doit être traité comme un brouillon que l'artisan vérifie, comme tout le reste dans ce système. Ne pas construire tant que le générateur de base ne fonctionne pas et n'est pas prouvé sur les devis réels d'un vrai client.

Décisions de Conception et Calibration par Client

  1. Nombre minimum d'échantillons de devis — Calibré par client. La recherche sectorielle (bid-anatomy-residential-remodeling.md) décrit la forme standard d'un devis mais ne peut pas nous dire à quel point les vrais devis d'un artisan varient les uns des autres. Hypothèse de départ : 2-3 minimum, plus si les types de projets varient considérablement. Confirmé par client à partir de ses échantillons réels.
  2. Format de document que les artisans utilisent réellement — RÉSOLU. Le livrable final destiné au client est massivement un PDF fini, quel que soit l'outil de rédaction (Word, devis basé sur Excel, ou logiciel de proposition dédié). Confirmez toujours le format du modèle source par client, car ce que le générateur édite peut différer même lorsque le résultat converge vers le PDF. Voir bid-anatomy-residential-remodeling.md pour plus de détails.
  3. Adaptation spécifique au métier — AMORCÉ (extension v2). La recherche actuelle de cette compétence (bid-anatomy-residential-remodeling.md) est limitée à la rénovation résidentielle spécifiquement. Un trade-adaptation-guide.md pour d'autres métiers (couvreur, plombier, etc.) est l'extension v2 et suit le même modèle de guide d'adaptation que lead-capture-skill une fois que d'autres métiers auront été recherchés ou intégrés.

Principe Clé

L'extraction du style et du modèle, les garde-fous juridiques, le versionnage et la génération doivent tous rester cohérents les uns avec les autres pour une entreprise cliente donnée — un changement dans l'un (par exemple, l'artisan corrige son modèle) devrait inciter à vérifier si les autres (par exemple, le profil de style) ont besoin d'être mis à jour également.

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

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

Generates branded, print-ready PWS service agreements, retainer terms, and consent/access forms from a client's real scope — one agreement per build, 20/80 payment, fillable Automation Builds table with auto-totaled price, black-and-white tables, no baked-in discount math.

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