MoizIbnYousaf/marketing-cli/skills/positioning-angles/SKILL.md
positioning-angles
Find the angle that makes something sell. Use this skill whenever the user mentions positioning, angles, differentiation, unique selling proposition, 'how do I stand out', 'what makes us different', value proposition, messaging framework, or 'find the hook'. Also trigger when copy isn't converting (often a positioning problem), when marketing feels generic, when launching a product, creating a lead magnet, writing a landing page, or entering a crowded market. Even if the user is about to write c
- Source repository stars
- 27
- Declared platforms
- 0
- Static risk flags
- 2
- Last source update
- 2026-07-28
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
1. Check if brand/ directory exists in the project root. 2. If it does, read available files: voice-profile.md, positioning.md, audience.md, creative-kit.md, stack.md, learnings.md. 3. Apply any loaded brand context to enhance output quality. 4. If brand/ does not exist, proceed…
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
| 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
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.
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill "skills/positioning-angles"Inspect the Agent Skill "positioning-angles" from https://github.com/MoizIbnYousaf/marketing-cli/blob/f12fbcbe4929584697b309b9096c9427b0cfce8e/skills/positioning-angles/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
- 01
The angle-finding process
Not the product. The transformation.
Do nothing (live with the problem)DIY (cobble together a solution)Hire someone (consultant, freelancer, agency) - 02
Step 1: Identify what they are actually selling
Not the product. The transformation.
Not the product. The transformation.Ask: What does the customer's life look like AFTER? What pain disappears? What capability appears? What status changes?A fitness program does not sell workouts. It sells "fit into your old jeans" or "keep up with your kids" or "look good naked." - 03
Step 2: Map the competitive landscape
What would customers do if this did not exist? Not competitors -- alternatives.
Do nothing (live with the problem)DIY (cobble together a solution)Hire someone (consultant, freelancer, agency) - 04
Step 2.5: Competitive web search (live data)
Before generating angles, search the web for real competitor messaging. This grounds the angle work in current market reality rather than assumptions.
Identify search targets:If ./brand/competitors.md exists, start with those competitor names and URLsIf the user named competitors, search those - 05
Step 3: Find the unique mechanism
The mechanism is HOW the product delivers results differently.
What is the proprietary process, method, or system?What do you do differently than the obvious approach?What is the counterintuitive insight that makes this work?
Permission review
Static risk signals and limitations
Reads files
The documentation asks the agent to read local files, directories, or repositories.
Read the existing positioning fileNetwork access
The documentation includes network, browsing, or remote request actions.
Before generating angles, search the web for real competitor messaging. This grounds the angle work in current market reality rather than assumptions.Evidence record
Why each signal appears
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 87/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
Provenance and original SKILL.md
- Repository
- MoizIbnYousaf/marketing-cli
- Skill path
- skills/positioning-angles/SKILL.md
- Commit
- f12fbcbe4929584697b309b9096c9427b0cfce8e
- License
- MIT
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
On Activation
- Check if
brand/directory exists in the project root. - If it does, read available files:
voice-profile.md,positioning.md,audience.md,creative-kit.md,stack.md,learnings.md. - Apply any loaded brand context to enhance output quality.
- If
brand/does not exist, proceed without it — this skill works standalone. - Read
brand/landscape.mdif it exists — check the Claims Blacklist before making ecosystem or competitive claims. If stale (>14 days) or missing, warn that market claims may be outdated.
Note: Examples below use fictional brands (Acme, Lumi, Helm). Replace with your own brand context.
Positioning & Angles
The same product can sell 100x better with a different angle. Not a different product. Not better features. Just a different way of framing what it already does.
This skill finds those angles.
Brand memory integration
Reads: audience.md, competitors.md, voice-profile.md (if they exist)
On invocation, check for ./brand/ and load available context:
-
Check for
./brand/positioning.md-- if it exists, this is an update session:- Read the existing positioning file
- Display the current primary angle and any saved alternatives
- Ask: "You already have positioning on file. Do you want to refine it with fresh data, or start from scratch?"
- "Refine" -- load existing angles, run competitive search for new data, suggest adjustments to current positioning based on what has changed in the market
- "Start fresh" -- run the full process below as if no positioning exists
-
Load
audience.md(if exists):- Use audience segments, pain points, and language patterns to inform angle generation
- Show: "I see your audience profile -- [brief summary]. Using that to shape angles."
-
Load
competitors.md(if exists):- Use known competitors as starting seeds for the competitive web search step
- Show: "I found [N] competitors in your brand memory. Starting search from there."
-
Load
voice-profile.md(if exists):- Use voice DNA to ensure angle language matches brand tone
- Show: "Your voice is [tone summary]. Angles will match that register."
-
If
./brand/does not exist:- Skip brand loading entirely. Do not error.
- Note in opening message: "No brand profile found — this skill works standalone. I'll ask what I need. You can run /cmo or /brand-voice later to unlock personalization."
The core job
When someone asks about positioning or angles, the goal is not to find THE answer. It is to surface multiple powerful options they can choose from.
Every product has several valid angles. The question is which one resonates most with the specific audience at the specific moment.
Output format: 3-5 distinct angle options, numbered with circled numbers, each with:
- Statement (one sentence positioning)
- Psychology (why this works with this audience)
- Headline direction (how it would sound in copy)
- Best for (market conditions, audience segments)
- One option marked with ★ recommended
The angle-finding process
Step 1: Identify what they are actually selling
Not the product. The transformation.
Ask: What does the customer's life look like AFTER? What pain disappears? What capability appears? What status changes?
A fitness program does not sell workouts. It sells "fit into your old jeans" or "keep up with your kids" or "look good naked."
A SaaS tool does not sell features. It sells "close your laptop at 5pm" or "never lose a lead" or "stop the spreadsheet chaos."
The transformation is the raw material for angles.
Step 2: Map the competitive landscape
What would customers do if this did not exist? Not competitors -- alternatives.
- Do nothing (live with the problem)
- DIY (cobble together a solution)
- Hire someone (consultant, freelancer, agency)
- Buy a different category (different approach entirely)
- Buy a direct competitor
Each alternative has weaknesses. Those weaknesses become angle opportunities.
Angle opportunity: What is frustrating about each alternative that this solves?
Step 2.5: Competitive web search (live data)
Before generating angles, search the web for real competitor messaging. This grounds the angle work in current market reality rather than assumptions.
Search process:
-
Identify search targets:
- If
./brand/competitors.mdexists, start with those competitor names and URLs - If the user named competitors, search those
- Otherwise, search for "[product category] + [target market]" to find the top players
- If
-
Pull messaging data from competitor sites:
- Homepage headlines and hero copy
- Taglines and value propositions
- Key claims on feature/pricing pages
- Social proof framing (how they present testimonials)
- CTA language
-
Map the landscape:
- What claims appear on 3+ competitor sites (saturated territory)
- What angles only 1 competitor uses (partially claimed)
- What angles NO competitor uses (white space)
- What proof/mechanism language dominates the space
-
Present findings as a competitive landscape map:
──────────────────────────────────────────────────
COMPETITIVE MESSAGING LANDSCAPE
──────────────────────────────────────────────────
Competitors Analyzed
├── [Competitor 1] -- "[their headline]"
├── [Competitor 2] -- "[their headline]"
├── [Competitor 3] -- "[their headline]"
└── [Competitor 4] -- "[their headline]"
──────────────────────────────────────────────
Saturated Claims (everyone says this)
├── "[Claim 1]"
├── "[Claim 2]"
└── "[Claim 3]"
Partially Claimed (1-2 competitors)
├── "[Claim]" -- used by [Competitor]
└── "[Claim]" -- used by [Competitor]
Underexploited Territory
├── Nobody is talking about [gap 1]
├── The [specific angle] is wide open
└── [Niche audience] has no champion
──────────────────────────────────────────────────
Why this matters: Angles built on white space outperform angles that echo the market. If every competitor says "all-in-one platform," that phrase is dead. The competitive search reveals what NOT to say and where opportunity lives.
If web search is unavailable:
- Use
./brand/competitors.mdif it exists — extract messaging data from previous competitive intel. - If no competitors.md exists, ask the user to name 2-3 competitors and describe their positioning.
- If no competitor data is available at all, skip the competitive landscape map and note the limitation: "Angles are not competitively grounded. Run /competitive-intel first for stronger differentiation."
- Proceed to Step 3 with whatever context is available — the skill still works without competitive data, just at a lower enhancement level.
Step 3: Find the unique mechanism
The mechanism is HOW the product delivers results differently.
Not "we help you lose weight" (that is the promise). "We help you lose weight through intermittent fasting optimized for your metabolic type" (that is the mechanism).
The mechanism makes the promise believable. It answers: "Why will this work when other things have not?"
Questions to surface the mechanism:
- What is the proprietary process, method, or system?
- What do you do differently than the obvious approach?
- What is the counterintuitive insight that makes this work?
- What is the "secret" ingredient, step, or element?
Even if nothing is truly proprietary, there is always a mechanism. Name it.
Step 4: Assess market sophistication
Where is the market on Schwartz's awareness scale?
Stage 1 (New category): The market has not seen this before. Angle: Simple announcement. "Now you can [do thing]."
Stage 2 (Growing awareness): Competition exists, market is warming. Angle: Claim superiority. "The fastest/easiest/most complete way to [outcome]."
Stage 3 (Crowded): Many players, similar claims, skepticism rising. Angle: Explain the mechanism. "Here is WHY this works when others do not."
Stage 4 (Jaded): Market has seen everything, needs new frame. Angle: Identity and belonging. "For people who [identity marker]."
Stage 5 (Iconic): Established leaders, brand loyalty matters. Angle: Exclusive access. "Join the [tribe/movement]."
The market stage determines which angle TYPE will work.
Step 5: Run the angle generators
Now generate options using multiple frameworks. Each generator is a lens -- run the product through several and keep the 3-5 strongest options.
The Contrarian Angle
What does everyone in this market believe that might not be true? Challenge that assumption directly.
"Everything you've been told about [topic] is wrong." "Stop [common practice]. Here's what actually works."
Works when: Market is frustrated with conventional approaches. Audience sees themselves as independent thinkers.
The Unique Mechanism Angle
Lead with the HOW, not just the WHAT. Name the proprietary process or insight.
"The [Named Method] that [specific result]" "How [mechanism] lets you [outcome] without [usual sacrifice]"
Works when: Market is sophisticated (Stage 3+). Similar promises exist. Need to differentiate.
The Transformation Angle
Before and after. The gap between current state and desired state.
"From [painful current state] to [desired outcome]" "Go from [specific bad metric] to [specific good metric] in [timeframe]"
Works when: The transformation is dramatic and specific. Market is problem-aware.
The Enemy Angle
Position against a common enemy (not a competitor -- a problem, a mindset, an obstacle).
"Stop letting [enemy] steal your [valuable thing]" "The [enemy] is lying to you. Here's the truth."
Works when: Audience has shared frustrations. There is a clear villain to rally against.
The Speed/Ease Angle
Compress the time or reduce the effort.
"[Outcome] in [surprisingly short time]" "[Outcome] without [expected sacrifice]"
Works when: Alternatives require significant time or effort. Speed/ease is genuinely differentiated.
The Specificity Angle
Get hyper-specific about who it is for or what it delivers.
"For [very specific avatar] who want [very specific outcome]" "The [specific number] [specific things] that [specific result]"
Works when: Competing with generic offerings. Want to signal "this is built for YOU."
The Social Proof Angle
Lead with evidence, not claims.
"[Specific result] for [number] [type of people]" "How [credible person/company] achieved [specific outcome]"
Works when: Have strong proof. Market is skeptical. Trust is the primary barrier.
The Risk Reversal Angle
Make the guarantee the headline.
"[Outcome] or [dramatic consequence for seller]" "Try it for [time period]. [Specific guarantee]."
Works when: Risk is the primary objection. Confidence in delivery is high.
Worked Example
Product: Acme (verified meal delivery) Market awareness: Stage 2 (Problem-Aware)
Top 3 angles generated:
- Unique Mechanism — 'The only delivery app with on-site source inspectors' (differentiator: human verification vs. self-reported labels)
- Enemy — 'DoorDash calls it verified. We actually check.' (names the villain: unverified-source claims)
- Transformation — 'From ingredient-checking every order to ordering with your eyes closed' (before/after emotional state)
Recommended: Angle 2 (Enemy) — creates urgency, names a known frustration, and positions Acme as the trusted alternative.
Progressive Enhancement Levels
| Level | Context Available | Output Quality |
|---|---|---|
| L0 | Product description only, no web search | 3-5 angles from frameworks, no competitive grounding |
| L1 | + audience.md | Audience-aware angles, pain-point-driven psychology |
| L2 | + competitors.md | Competitively grounded angles, gap-exploiting positioning |
| L3 | + web search for live competitive messaging | Real-time white space identification, verified saturated claims |
| L4 | + existing positioning.md (refinement) | Evolved angles with market shift tracking |
Output format
All output uses the four required sections: Header, Content, Files Saved, What's Next.
Header
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
POSITIONING ANGLES
[Product/Offer Name]
Generated [Month Day, Year]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Content: Competitive Landscape Map
Present the competitive search findings first (see Step 2.5 format above).
Content: Market Assessment
MARKET ASSESSMENT
Sophistication: Stage [N] -- [stage name]
Transformation: [one sentence]
Mechanism: [the unique how]
Primary alternative: [what they do instead]
Content: Angle Options
Present 3-5 numbered angle options using circled numbers (①②③④⑤). Each option includes: Statement (one sentence), Psychology (why it works), Headline (example), Best for (conditions). Mark the strongest with ★ recommended, then explain why in 1-2 sentences. Ask: "Which angle resonates? Pick a number, or tell me to combine elements from multiple."
Files Saved
After the user selects an angle, write to ./brand/positioning.md:
FILES SAVED
./brand/positioning.md ✓
If the file already existed and was updated:
FILES SAVED
./brand/positioning.md ✓ (updated)
What's Next
WHAT'S NEXT
Your positioning is set. Every downstream
skill will use this angle. Recommended moves:
→ /direct-response-copy Write copy with your
winning angle (~15 min)
→ /lead-magnet Build a lead gen
asset (~10 min)
→ /keyword-research Map your content
territory (~15 min)
Or tell me what you're working on and
I'll route you.
File output protocol
When the user selects an angle, write ./brand/positioning.md with: Last Updated date, Primary Positioning (angle name, statement, psychology, headline direction, best for), Competitive Landscape Summary (sophistication stage, saturated claims, white space), and All Angles Explored (statement + headline for each generated angle, marking the selected one).
If ./brand/positioning.md already exists, show what will change ("Your current positioning focuses on X, the new version shifts to Y"), ask for confirmation, and only overwrite after explicit approval.
12-ad matrix seed (optional)
After the user selects an angle, offer to generate a 12-ad testing matrix: 4 hooks (direct statement, question, proof, contrarian) across 3 formats (static image, video, carousel). Each cell gets a unique ID for performance tracking.
See references/ad-matrix-and-examples.md for the full matrix template, cell structure, and the complete Claude Skills Pack worked example.
How this skill gets invoked
This skill activates when:
- User asks "how should I position X"
- User asks "what's the angle for X"
- User asks "why isn't this selling"
- User asks to "find the hook" or "make this stand out"
- User is about to write copy/landing page but has not established positioning
- Direct-response-copy skill needs an angle to write from
- Landing-page skill needs a core positioning to build around
When another skill needs an angle, run this first. The angle informs everything downstream.
What this skill is NOT
This skill finds positioning and angles. It does NOT:
- Write the actual copy (that is direct-response-copy)
- Build the landing page structure (that is landing-page)
- Research the audience from scratch (assumes you know who you are selling to, or loads audience.md)
- Pick a single "right" answer (it gives options to choose from)
- Replace deep competitive intelligence (that is competitive-intel -- this does a messaging-focused scan)
The output is strategic direction, not finished marketing.
The test
Before delivering angles, verify each one:
-
Is it specific? Vague angles ("better results") fail. Specific angles ("20 lbs in 6 weeks") convert.
-
Is it differentiated? Could a competitor claim the same thing? If yes, sharpen it. Cross-reference against the competitive landscape map -- if a competitor already says it, it fails this test.
-
Is it believable? Does the mechanism or proof support the claim?
-
Is it relevant to THIS audience? An angle that works for beginners fails for experts. If audience.md is loaded, verify alignment with known segments and pain points.
-
Does it lead somewhere? Can you imagine the headline, the landing page, the copy? If not, it is too abstract.
Iteration and update mode
This section adds detail to the iteration path described in "Brand memory integration" step 1. When ./brand/positioning.md already exists, display current primary angle and offer: "Refine this, or start fresh?"
Refine mode: Load existing angles, run fresh competitive web search, compare new landscape to saved landscape, identify shifts (new competitors, new saturated claims, new white space), and suggest specific adjustments. Present 1-3 refined variations alongside the original. Let the user choose to keep, tweak, or replace.
Start fresh mode: Run the complete process from Step 1. Previous positioning.md is preserved until the user explicitly confirms the replacement.
Feedback collection
After delivering the final angle selection and writing to positioning.md:
How did this perform?
a) Great -- using this angle as-is
b) Good -- tweaked the language slightly
c) Rewrote significantly
d) Haven't used yet
(You can answer later -- just run
/positioning-angles again and tell me.)
Processing feedback:
-
(a) Great: Log to
./brand/learnings.mdunder "What Works" with the angle name and context. Example:- [2026-02-16] [/positioning-angles] "The Capability Transfer" angle shipped as-is. Stage 3 market, builder audience. -
(b) Good -- tweaked: Ask what changed. Log the adjustment to learnings.md. If the tweak reveals a voice mismatch, suggest re-running /brand-voice.
-
(c) Rewrote significantly: Ask for the final version. Analyze differences. Log findings. If the rewrite suggests fundamentally different positioning, offer to update positioning.md with their version.
-
(d) Haven't used yet: Note it. Do not log. Optionally remind next time.
References
For deeper frameworks, see the references/ folder:
dunford-positioning.md-- April Dunford's 5-component positioning methodologyschwartz-sophistication.md-- Eugene Schwartz's market awareness levelsunique-mechanism.md-- How to find and name your mechanismangle-frameworks.md-- Halbert, Ogilvy, Hopkins, Bencivenga, Kennedy approacheshormozi-offer.md-- Value equation and Grand Slam Offer thinkingad-matrix-and-examples.md-- 12-ad testing matrix template and full Claude Skills Pack worked example
Alternatives
Compare before choosing
coreyhaines31/marketingskills
attribution
When the user wants to figure out which marketing actually drives conversions and revenue, choose or interpret an attribution model, or reconcile conflicting numbers across tools. Also use when the user mentions "attribution," "attribution model," "first-touch vs last-touch," "multi-touch," "which channel drives revenue," "what's my real CAC," "my dashboards disagree," "Google/Meta says X but GA says Y," "media mix model," "MMM," "incrementality," "geo lift," "holdout test," "how did you hear ab
coreyhaines31/marketingskills
emails
When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold out
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
MoizIbnYousaf/marketing-cli
direct-response-copy
Write copy that converts. Use when writing landing pages, emails, sales copy, headlines, CTAs, social posts, cold emails, or any persuasive text. Triggers on 'copy', 'copywriting', 'sales copy', 'landing page copy', 'cold email', 'headlines', 'write me a page', 'make this convert', 'rewrite this copy', or any request involving persuasive writing. Three modes: Generate (write from scratch), Edit (improve existing copy with Seven Sweeps), Cold Email (outbound sequences). If someone has text that n