Source profileQuality 80/100

MoizIbnYousaf/marketing-cli/skills/deepen-plan/SKILL.md

deepen-plan

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

Source repository stars
27
Declared platforms
0
Static risk flags
0
Last source update
2026-07-28
Source checked
2026-07-28

Decision brief

What it does—and where it fits

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.

Best for

  • Use when the agent has a draft plan (brand strategy, campaign brief, content calendar, launch plan) that needs strengthening with real data.

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill "skills/deepen-plan"
Safe inspection promptEditorial

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

What the source asks the agent to do

  1. 01

    Phase 0: Assess the Plan

    Read the existing plan and classify it:

    Read the existing plan and classify it: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.
  2. 02

    Phase 1: Gap Analysis

    Score the plan across 5 dimensions. For each, rate as strong, weak, or missing:

    Specific data points (numbers, names, quotes) rather than vague statementsActionable details an agent or human could execute onEvidence of research, not just assumptions
  3. 03

    Phase 2: Parallel Research

    Spawn research agents based on the gaps found. Use the Agent tool to run up to 3 agents simultaneously in a single message:

    Provide: the product/project name, what it does, who the plan currently targets (if stated)Agent writes to brand/audience.mdTell it: "Research the target audience for [product]. The current plan says [quote relevant section]. Find buyer personas, where they hang out online, what language they use, and what objections they have. Write finding…
  4. 04

    Phase 3: Synthesize

    After all research agents complete, merge findings into the plan. Follow these rules:

    Read the research outputs — brand/audience.md, brand/competitors.md, or any other files the agents wrote.Do not rewrite the plan. Add to it. The user's original thinking is preserved.For each gap that was researched, add a new subsection within the relevant part of the plan:
  5. 05

    Phase 4: Handoff

    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.

    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.Append a deepening log at the bottom of the plan: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

Static risk signals and limitations

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

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score80/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars27SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
MoizIbnYousaf/marketing-cli
Skill path
skills/deepen-plan/SKILL.md
Commit
f12fbcbe4929584697b309b9096c9427b0cfce8e
License
MIT
Collected
2026-07-28
Default branch
main
View the original SKILL.md

/deepen-plan — Plan Enhancement with Parallel Research

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.

On Activation

  1. Read brand/ files if they exist (voice-profile.md, audience.md, competitors.md, positioning.md, keyword-plan.md). They enhance but never gate.
  2. Identify the plan to deepen — the user will either point to a file or have one in context.

Phase 0: Assess the Plan

Read the existing plan and classify it:

Plan TypeSignalsCommon Gaps
Brand strategyVoice, positioning, valuesMissing audience data, no competitive differentiation
Campaign briefTimeline, channels, messagesVague audience, no keyword backing, weak positioning
Content calendarTopics, dates, channelsNo keyword research, missing distribution strategy
Launch planTimeline, milestones, channelsNo competitive landscape, missing pricing context
Brainstorm outputApproaches, recommendationsEverything — 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.

Phase 1: Gap Analysis

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."

Quality Gate

A dimension is strong when it contains:

  • Specific data points (numbers, names, quotes) rather than vague statements
  • Actionable details an agent or human could execute on
  • Evidence of research, not just assumptions

A dimension is weak when it:

  • States the obvious without specifics ("target tech-savvy users")
  • Has the right structure but lacks data backing
  • Makes claims without evidence

A dimension is missing when:

  • The section doesn't exist at all
  • It's a single vague sentence

Phase 2: Parallel Research

Spawn research agents based on the gaps found. Use the Agent tool to run up to 3 agents simultaneously in a single message:

When audience is weak or missing:

Spawn mktg-audience-researcher:

  • Provide: the product/project name, what it does, who the plan currently targets (if stated)
  • Agent writes to brand/audience.md
  • Tell it: "Research the target audience for [product]. The current plan says [quote relevant section]. Find buyer personas, where they hang out online, what language they use, and what objections they have. Write findings to brand/audience.md."

When competitive positioning is weak or missing:

Spawn mktg-competitive-scanner:

  • Provide: the product/project name, market space, any competitors mentioned in the plan
  • Agent writes to brand/competitors.md
  • Tell it: "Research competitors for [product] in the [space] market. The current plan mentions [competitors if any]. Find 3-5 competitors, their positioning, pricing, strengths, and weaknesses. Write findings to brand/competitors.md."

When keyword/search strategy is weak or missing:

Do NOT spawn an agent. Instead, note that keyword research should be run after deepening:

  • Add to the synthesis: "Keyword strategy gap identified. After this deepening pass, run /keyword-research to fill this with real search data."

When distribution is weak or missing:

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.

When success metrics are weak or missing:

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.

Phase 3: Synthesize

After all research agents complete, merge findings into the plan. Follow these rules:

  1. Read the research outputsbrand/audience.md, brand/competitors.md, or any other files the agents wrote.
  2. Do not rewrite the plan. Add to it. The user's original thinking is preserved.
  3. For each gap that was researched, add a new subsection within the relevant part of the plan:
### 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]
  1. Strengthen existing sections — If the plan had a weak audience section, enhance it with specifics from the research. Add quotes, data points, persona details. Don't replace the original text; build on it.
  2. Fill distribution gaps using audience data — "Your audience is active in [communities/platforms]. Add these to your distribution plan: [specific channels]."
  3. Fill metrics gaps based on plan type:
    • Brand strategy -> awareness metrics (search volume, social mentions, brand recall)
    • Campaign brief -> campaign metrics (CTR, conversion rate, CAC)
    • Content calendar -> content metrics (organic traffic, time on page, email signups)
    • Launch plan -> launch metrics (day-1 signups, activation rate, press mentions)

Phase 4: Handoff

  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-<topic>-deepened.md.

  2. 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]
  1. Append to 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].
  1. Tell the user what changed: "Plan deepened. Here's what I added: [2-3 sentence summary]. The biggest insight from research was [highlight]. Your plan now has [strong count]/5 dimensions covered. Suggested next step: /[skill] to [reason]."

Anti-Patterns

Anti-patternWhy it failsInstead
Rewriting the user's plan from scratchThe user's original thinking contains context and decisions you don't have — overwriting it loses institutional knowledgeAdd to existing sections, preserve original thinking
Running all 5 research types regardlessResearching what's already strong wastes time and may contradict validated decisions the user already madeOnly research actual gaps — strong sections don't need more data
Spawning agents for keyword or distribution gapsKeyword research is a complex methodology that deserves its own skill run — a quick agent pass produces shallow results that misleadKeywords need /keyword-research skill. Distribution is synthesized from audience data
Deepening a plan that doesn't exist yetYou can't enhance nothing — the agent will hallucinate a plan and then deepen its own hallucinationRoute to /brainstorm or /launch-strategy first
Running without showing the gap analysisThe user should see and approve what you're about to research — surprise research wastes cycles if they already know the answersAlways show the gap table and explain what you'll research
Silently updating brand filesBrand files persist across sessions — silent updates may overwrite previous research the user relied onAgents write to brand/. That's fine. But tell the user what was updated
Deepening the same plan twice without new contextDouble-deepening without new information just adds redundant research and makes the plan harder to readFlag it: "This plan was already deepened on [date]. Want me to research something specific, or has the situation changed?"

YAGNI Principles

  • Don't research what's already strong. A solid audience section doesn't need more audience research.
  • Don't add sections the plan doesn't need. A content calendar doesn't need a pricing analysis.
  • Don't create a new plan. This skill enhances, it doesn't generate.
  • Don't run keyword research inline. That's a dedicated skill with its own methodology.
  • The gap analysis table is the decision framework. If it shows all strong, you're done.

Related Skills

  • brainstorm: When no plan exists yet and the user needs direction
  • launch-strategy: When the plan to deepen is a launch plan, or when no plan exists
  • keyword-research: For filling keyword/search strategy gaps identified in gap analysis
  • audience-research: For deep-dive audience work beyond what the researcher agent provides
  • competitive-intel: For deep competitive analysis beyond the scanner agent

Alternatives

Compare before choosing

Computed 9327

MoizIbnYousaf/marketing-cli

off-page-seo

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

Computed 9237,126

github/awesome-copilot

competitor-ad-intelligence

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.

Computed 9227

MoizIbnYousaf/marketing-cli

seo-machine

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

Computed 9142,015

coreyhaines31/marketingskills

sales-enablement

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