inbox-placement

Diagnose email inbox placement issues across Gmail, Outlook, and Yahoo providers.

2|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/chunkydotdev/email-skills --skill inbox-placement
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: inbox-placement
Source: https://github.com/chunkydotdev/email-skills/tree/main/skills/deliverability/inbox-placement
Command: npx skills add https://github.com/chunkydotdev/email-skills --skill inbox-placement

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates guesswork when emails land in spam folders, Gmail Promotions tabs, or Outlook Other inboxes despite proper SPF/DKIM/DMARC authentication setup, or when launching new sending domains and needing to maximize initial inbox placement. It breaks down the exact signal hierarchy (sender reputation, engagement, authentication, content, infrastructure) that major mailbox providers use to classify incoming email, so you can target fixes to the highest-impact areas instead of wasting time on low-impact content tweaks.

Core Features & Use Cases

  • Signal Hierarchy Breakdown: Clear 2025 weighting of key placement signals across Gmail, Microsoft, and Yahoo, so you know what to prioritize first for maximum impact.
  • Provider-Specific Placement Guides: Step-by-step guidance for optimizing Gmail Primary vs Promotions tab placement, Microsoft Focused vs Other vs Junk filtering, and meeting 2025 bulk sender requirements for each provider.
  • Diagnostic & Monitoring Frameworks: Actionable troubleshooting steps for spam placement, tab misclassification, high bounce rates, spam trap risks, and engagement decay, plus guidance on setting up inbox placement testing and monitoring key metrics long-term.
  • Use Case: If your marketing emails are landing in Gmail Promotions despite strong engagement, use this Skill to adjust your sending practices, content, and engagement strategy to either move toward Primary tab placement or optimize your Promotions tab performance for better open rates.

Quick Start

Use the inbox-placement skill to diagnose why your recent campaign emails are landing in Gmail Spam instead of the Primary inbox, and get a prioritized list of fixes to implement first.

Frequently Asked Questions about inbox-placement

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

FAQPage Schema
Why does my email land in the Gmail Promotions tab instead of the Primary inbox?

Emails land in the Gmail Promotions tab when sender reputation and engagement signals indicate marketing content. Adjusting sending practices, content structure, and engagement strategy can shift placement toward the Primary inbox or optimize Promotions tab open rates.

How do I fix email deliverability issues when my messages go to spam folders?

Fixing spam folder placement requires diagnosing the signal hierarchy across mailbox providers. Prioritize sender reputation, engagement metrics, and authentication infrastructure to target the highest-impact areas for resolving email deliverability issues.

What are the 2025 bulk sender requirements for Gmail, Microsoft, and Yahoo?

2025 bulk sender requirements for Gmail, Microsoft, and Yahoo mandate strict SPF, DKIM, and DMARC authentication protocols alongside engagement thresholds. Meeting these provider-specific signal weightings ensures compliance and maximizes inbox delivery rates.

How can I improve Outlook inbox placement to avoid the Other or Junk folders?

Improving Outlook inbox placement involves optimizing signals for Microsoft Focused vs Other vs Junk filtering. Address sender reputation, content structure, and engagement decay to prevent misclassification and ensure emails reach the primary inbox.

How do I test inbox placement before sending a bulk email campaign?

Test inbox placement using seed lists to evaluate deliverability across major mailbox providers. This diagnostic framework identifies spam filter avoidance risks, validates authentication infrastructure, and monitors placement metrics before launching bulk campaigns.

What is the best way to warm up a new sending domain for maximum inbox delivery?

New domain onboarding for maximum inbox delivery requires gradual volume scaling to build positive sender reputation. Establish SPF, DKIM, and DMARC authentication protocols while monitoring engagement metrics to avoid initial spam folder misclassification.