Best for
- Use when the agent has a draft plan (brand strategy, campaign brief, content calendar, launch plan) that needs strengthening with real data.
MoizIbnYousaf/marketing-cli/skills/deepen-plan/SKILL.md
Enhance an existing marketing plan with parallel research. Use when the agent has a draft plan (brand strategy, campaign brief, content calendar, launch plan) that needs strengthening with real data. Triggers on 'deepen this plan', 'strengthen this strategy', 'research gaps in my plan', 'make this plan better', 'this plan is too surface level', 'add research to this', 'validate this plan', 'back this up with data', or when a plan exists but lacks audience data, competitive positioning, or keywor
Decision brief
The second pass. Takes an existing marketing plan and strengthens it with targeted research — audience data, competitive intel, keyword gaps — then merges findings back in.
Compatibility matrix
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill "skills/deepen-plan"Inspect the Agent Skill "deepen-plan" from https://github.com/MoizIbnYousaf/marketing-cli/blob/f12fbcbe4929584697b309b9096c9427b0cfce8e/skills/deepen-plan/SKILL.md at commit f12fbcbe4929584697b309b9096c9427b0cfce8e. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
Read the existing plan and classify it:
Score the plan across 5 dimensions. For each, rate as strong, weak, or missing:
Spawn research agents based on the gaps found. Use the Agent tool to run up to 3 agents simultaneously in a single message:
After all research agents complete, merge findings into the plan. Follow these rules:
1. Write the updated plan back to its original file location. If the plan was provided inline (not from a file), write to marketing/plans/YYYY-MM-DD--deepened.md.
Permission review
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 80/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 27 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
The second pass. Takes an existing marketing plan and strengthens it with targeted research — audience data, competitive intel, keyword gaps — then merges findings back in.
For brand memory protocol, see /cmo rules/brand-memory.md.
brand/ files if they exist (voice-profile.md, audience.md, competitors.md, positioning.md, keyword-plan.md). They enhance but never gate.Read the existing plan and classify it:
| Plan Type | Signals | Common Gaps |
|---|---|---|
| Brand strategy | Voice, positioning, values | Missing audience data, no competitive differentiation |
| Campaign brief | Timeline, channels, messages | Vague audience, no keyword backing, weak positioning |
| Content calendar | Topics, dates, channels | No keyword research, missing distribution strategy |
| Launch plan | Timeline, milestones, channels | No competitive landscape, missing pricing context |
| Brainstorm output | Approaches, recommendations | Everything — brainstorms are directional, not researched |
If no plan is found or provided:
"I need an existing plan to deepen. Either point me to a file or run /brainstorm or /launch-strategy first to create one."
If the plan is embedded in conversation context (not a file): extract the key sections and work with them inline. Note in the handoff that the deepened plan should be saved to a file.
Score the plan across 5 dimensions. For each, rate as strong, weak, or missing:
### Plan Gap Analysis
| Dimension | Status | Evidence |
|-----------|--------|----------|
| Audience clarity | [strong/weak/missing] | [What the plan says or doesn't] |
| Competitive positioning | [strong/weak/missing] | [What the plan says or doesn't] |
| Keyword/search strategy | [strong/weak/missing] | [What the plan says or doesn't] |
| Distribution plan | [strong/weak/missing] | [What the plan says or doesn't] |
| Success metrics | [strong/weak/missing] | [What the plan says or doesn't] |
Show this table to the user. Explain which gaps you'll fill and why they matter: "Your campaign brief has strong messaging but no audience data backing it. The competitive section is a single sentence. I'm going to research both in parallel — this will take a few minutes but will make the plan 3x more actionable."
If all dimensions are strong: "This plan is solid. I don't see gaps worth researching. If you want me to dig deeper on a specific section, tell me which one."
A dimension is strong when it contains:
A dimension is weak when it:
A dimension is missing when:
Spawn research agents based on the gaps found. Use the Agent tool to run up to 3 agents simultaneously in a single message:
Spawn mktg-audience-researcher:
brand/audience.mdSpawn mktg-competitive-scanner:
brand/competitors.mdDo NOT spawn an agent. Instead, note that keyword research should be run after deepening:
/keyword-research to fill this with real search data."Do NOT spawn an agent. Distribution gaps are filled during synthesis by cross-referencing audience data (where they hang out) with the plan's channel strategy.
Do NOT spawn an agent. Metrics are filled during synthesis based on the plan type and channels.
Minimum research: At least 1 agent must be spawned. If no gaps warrant an agent, skip to Phase 3 with a note.
Fallback: If agents are not installed (mktg doctor shows agents missing), read the corresponding skill files and execute the research inline — first audience, then competitive. This is slower but works everywhere.
After all research agents complete, merge findings into the plan. Follow these rules:
brand/audience.md, brand/competitors.md, or any other files the agents wrote.### Audience Research (Added [YYYY-MM-DD])
[Synthesized findings from audience-researcher, tailored to this plan's context]
### Competitive Landscape (Added [YYYY-MM-DD])
[Synthesized findings from competitive-scanner, tailored to this plan's context]
Write the updated plan back to its original file location. If the plan was provided inline (not from a file), write to marketing/plans/YYYY-MM-DD-<topic>-deepened.md.
Append a deepening log at the bottom of the plan:
---
## Deepened on [YYYY-MM-DD]
**Gaps addressed:**
- [List each gap and what was added]
**Research agents used:**
- [agent-name]: [one-line summary of findings]
**Remaining gaps:**
- [Any gaps not addressed and recommended next skill]
**Suggested next step:** /[skill-name] — [why]
brand/learnings.md (if it exists):- [YYYY-MM-DD] [/deepen-plan] Deepened [plan-type] for [project]. Key finding: [most surprising or actionable insight from research].
/[skill] to [reason]."| Anti-pattern | Why it fails | Instead |
|---|---|---|
| Rewriting the user's plan from scratch | The user's original thinking contains context and decisions you don't have — overwriting it loses institutional knowledge | Add to existing sections, preserve original thinking |
| Running all 5 research types regardless | Researching what's already strong wastes time and may contradict validated decisions the user already made | Only research actual gaps — strong sections don't need more data |
| Spawning agents for keyword or distribution gaps | Keyword research is a complex methodology that deserves its own skill run — a quick agent pass produces shallow results that mislead | Keywords need /keyword-research skill. Distribution is synthesized from audience data |
| Deepening a plan that doesn't exist yet | You can't enhance nothing — the agent will hallucinate a plan and then deepen its own hallucination | Route to /brainstorm or /launch-strategy first |
| Running without showing the gap analysis | The user should see and approve what you're about to research — surprise research wastes cycles if they already know the answers | Always show the gap table and explain what you'll research |
| Silently updating brand files | Brand files persist across sessions — silent updates may overwrite previous research the user relied on | Agents write to brand/. That's fine. But tell the user what was updated |
| Deepening the same plan twice without new context | Double-deepening without new information just adds redundant research and makes the plan harder to read | Flag it: "This plan was already deepened on [date]. Want me to research something specific, or has the situation changed?" |
Alternatives
MoizIbnYousaf/marketing-cli
Backlink + distribution checklist that expands a site's KD ceiling beyond what on-page work alone can earn. Use when the user mentions 'backlinks', 'off-page SEO', 'directory submissions', 'guest posts', 'outreach targets', 'link building', 'submit to directories', 'get listed in listicles', 'Product Hunt launch backlinks', or asks 'how do I get more domain authority'. Generates a prioritized, researched target list across directories, listicles, and guest-post candidates — does NOT submit anyth
github/awesome-copilot
Use this skill when the user asks to analyze, tear down, or reverse-engineer a competitor's paid ads. Trigger for prompts like "what ads is [competitor] running", "tear down their ad strategy", "competitor ad analysis", "find ad angles we haven't tried", or "reverse-engineer their paid funnel". Do not trigger for organic/SEO competitor research or website positioning analysis.
MoizIbnYousaf/marketing-cli
Build an organic-traffic operating system for any site or app: a multi-phase, resumable engine that ships programmatic landing pages (alternatives, comparisons, use-cases, playbooks) on top of real keyword research. Use when the user says 'SEO machine', 'build organic traffic', 'rank on Google', 'we need traffic', 'alternatives pages', 'comparison pages', '/for/ pages', 'programmatic SEO', or 'build an SEO engine'. Distinct from `seo-audit` (one-off diagnostic) and `seo-content` (single-article
coreyhaines31/marketingskills
When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts. Also use when the user mentions 'sales deck,' 'pitch deck,' 'one-pager,' 'leave-behind,' 'objection handling,' 'deal-specific ROI analysis,' 'demo script,' 'talk track,' 'sales playbook,' 'proposal template,' 'buyer persona card,' 'help my sales team,' 'sales materials,' or 'what should I give my sales reps.' Use this for any document or asset that helps a sales team close deals. Fo