crm-workflow

Automate CRM workflow state transitions for leads and quotes.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/michaelayoade/dotmac_crm --skill crm-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crm-workflow
Source: https://github.com/michaelayoade/dotmac_crm/tree/main/.claude/skills/crm-workflow
Command: npx skills add https://github.com/michaelayoade/dotmac_crm --skill crm-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates manual, error-prone CRM updates by ensuring lead, quote, and pipeline state changes reliably trigger the correct downstream actions (like project creation, order creation, notifications, and state/field updates).

Core Features & Use Cases

  • Workflow orchestration for CRM entities: Build or extend logic for lead conversion, quote acceptance, pipeline stage transitions, automation rules, and bulk operations across Lead, Quote, PipelineStage, Project, SalesOrder, and Person.
  • State-machine side effects on status changes: Enforce safe enum validation, update probabilities on stage moves, set terminal timestamps on won/lost outcomes, and upgrade person.party_status only in the correct direction (lead/contact → customer).
  • Quote/lead linkage and downstream creation patterns: Apply quote status propagation back to the lead, recalculate quote totals on line-item changes, and follow the existing _ensure_project_from_quote() pattern to create projects only when needed.

Quick Start

Ask the AI to build a workflow where a lead moved to “won” upgrades the linked person to a customer and automatically creates a project using a specified template.

Frequently Asked Questions about crm-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate lead conversion to create projects in my CRM?

Automating lead conversion requires applying state-machine side effects to status transitions, triggering project creation from accepted quotes. You enforce enum validation and use automation action handlers to whitelist field updates for downstream sales entities.

How does a state machine handle CRM pipeline stage probability updates?

A state machine handles pipeline stage probability updates by applying transition side effects during stage moves. It enforces safe enum validation and recalculates quote totals on line-item changes to ensure accurate downstream linkage.

Can I upgrade a person's party status from lead to customer automatically?

Yes, you can upgrade person party status automatically by implementing status transition side effects. The state machine ensures party status upgrades only in the correct direction from lead or contact to customer when a linked lead reaches a won outcome.

What is the best way to propagate quote acceptance back to a lead?

Propagating quote acceptance back to a lead involves applying quote status propagation patterns. You implement handlers that recalculate quote totals, validate entity linkage correctness, and trigger targeted tests to verify accepted behaviors.

Why does my CRM workflow automation fail on bulk operations?

CRM workflow automation fails on bulk operations when status transition side effects lack proper enum validation or automation action handlers have non-whitelisted field updates. Implementing strict state-machine rules and targeted tests prevents these errors.

Do I need specific templates to ensure project creation from accepted quotes?

Project creation from accepted quotes follows the existing ensure project from quote pattern. You need to configure automation rule-driven conversions that create projects only when needed, applying quote totals and entity linkage correctness checks.