troubleshooting-email

Diagnose CRM email issues with SQL and JMAP checks across staging and production.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Cimminelli1982/crm-frontend --skill troubleshooting-email
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting-email
Source: https://github.com/Cimminelli1982/crm-frontend/tree/main/docs/openclaw-skills/troubleshooting-email
Command: npx skills add https://github.com/Cimminelli1982/crm-frontend --skill troubleshooting-email

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, clear diagnostic process to identify and resolve common email system issues within the CRM, including staging vs production states, duplicate emails, and missing content.

Core Features & Use Cases

  • Step-by-step diagnostic checklists for common failure points in email processing, including spam blocking, staging status, and production linkage to contacts.
  • SQL queries and practical checks that help engineers quickly determine where an issue resides (Fastmail sync, staging, production) and how to fix it.
  • Use Case: A support engineer can quickly isolate why an email from a sender is not visible in the CRM and apply the correct remediation steps.

Quick Start

Run the troubleshooting email skill on an affected CRM instance to retrieve the current email state across Fastmail staging and production and present remediation steps.

Frequently Asked Questions about troubleshooting-email

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

FAQPage Schema
How do I diagnose CRM email issues when emails are not showing up in the inbox?

To diagnose CRM email issues, run a structured diagnostic checklist that checks Fastmail sync status, staging vs production states, spam blocking flags, and contact linkages across the command_center_inbox and emails tables to identify the failure point.

Why does a CRM email from a specific sender fail to link to the correct contact?

CRM emails fail to link to contacts when production linkage is broken, which can be confirmed by running SQL queries against the command_center_inbox and emails tables to verify missing associations and guide remediation steps.

What is the best way to troubleshoot Fastmail integration sync failures in a CRM?

The best way to troubleshoot Fastmail integration sync failures is by applying JMAP-based diagnostics to retrieve the current email state and confirm whether the issue resides in staging, production, or spam blocking.

How do I check if a missing CRM email was blocked by spam filters in production?

To check if a missing CRM email was blocked by spam filters, execute deterministic SQL checks on the staging and production environments to aggregate spam flags and verify the email's current processing status.

Can I use SQL queries to isolate duplicate emails in a CRM staging environment?

Yes, you can use SQL queries to isolate duplicate emails in a CRM staging environment by retrieving the current email state across Fastmail staging and production to identify duplicates and determine remediation steps.

Does troubleshooting CRM email synchronization require access to both staging and production databases?

Troubleshooting CRM email synchronization requires access to both staging and production databases to aggregate state differences, confirm staging status, and verify production linkage to contacts across the command_center_inbox and emails tables.