tech-marketing-framework
Turn Claude Code or Codex into a senior product marketer with repeatable skills for developer tools content, messaging, and campaign generation
Install
npx skills add https://github.com/reason-machines/marketing-skills --skill tech-marketing-frameworkTech Marketing Framework
Skill by ara.so — Marketing Skills collection.
A comprehensive marketing framework that turns Claude Code and Codex into a senior product marketer for technical audiences. Provides identity guidelines, content standards, template docs, and autonomous skills for content generation, messaging workshops, and campaign optimization.
What It Does
This project provides:
- Identity and voice guidelines that prioritize technical accuracy over marketing fluff
- Content guidelines with strict standards for writing, formatting, and AI discoverability
- Template docs for product briefs, personas, competitive intel, and messaging
- Skills for content generation (email sequences, social posts, messaging workshops)
- Autoresearch for autonomous skill optimization via binary evals
Installation
Prerequisites: Claude Code CLI or OpenAI Codex CLI
# Install Claude Code CLI
npm install -g @anthropic-ai/claude-code
# Or install OpenAI Codex CLI
npm install -g @openai/codex
# Clone the framework into your project
git clone https://github.com/j1ngg/tech-marketing-framework.git
cd tech-marketing-framework
# Run Claude Code
claude
# Or run Codex
codex
Claude Code automatically loads claude.md and .claude/ directory.
Codex automatically loads AGENTS.md and .agents/skills/ directory.
Project Structure
├── AGENTS.md # Codex repo instructions
├── claude.md # Claude Code instructions
├── .agents/skills/ # Codex skill wrappers
├── .claude/
│ ├── rules/
│ │ └── content-guidelines.md # Writing standards
│ ├── skills/ # Marketing skill workflows
│ │ ├── messaging-positioning/
│ │ ├── social-posts/
│ │ ├── email/
│ │ ├── ads/
│ │ ├── sales-deck/
│ │ ├── blog/
│ │ ├── editorial-calendar/
│ │ ├── image/
│ │ ├── launch-roundup/
│ │ ├── producthunt-launch/
│ │ └── autoresearch/
│ └── agents/
│ ├── asset-reviewer.md
│ ├── ads-auditor.md
│ └── how-they-market.md
├── docs/
│ ├── inputs/ # Product-specific templates
│ │ ├── product_brief.md
│ │ ├── target_personas.md
│ │ ├── messaging_positioning.md
│ │ ├── competitor_intel.md
│ │ ├── testimonials.md
│ │ └── brand_guidelines.md
│ └── reference/
│ └── channel_directory.md
└── output/ # Generated assets
├── social/
├── blog/
├── email/
├── ads/
├── decks/
├── images/
└── research/
Getting Started
1. Fill in Product Templates
Navigate to docs/inputs/ and complete these foundational documents:
# Edit product brief with your product details
vi docs/inputs/product_brief.md
# Define your target personas
vi docs/inputs/target_personas.md
# Add competitor intelligence
vi docs/inputs/competitor_intel.md
# Include approved customer testimonials
vi docs/inputs/testimonials.md
Required fields in product_brief.md:
- Product name and tagline
- Core problem solved
- Key features and capabilities
- Target audience
- Unique value proposition
Required fields in target_personas.md:
- Persona name and role
- Pain points
- Goals and success metrics
- Preferred channels
- Technical sophistication level
2. Run Your First Skill
In Claude Code, use slash commands:
/messaging-positioning
In Codex, use dollar sign or plain English:
$messaging-positioning
or simply ask:
Help me build a messaging framework for my product
Core Skills
Messaging & Positioning Workshop
Interactive workshop that builds your messaging foundation:
/messaging-positioning
Walks through four discovery sections:
- Vision - Long-term company direction
- Product - Capabilities and differentiation
- Competitive - Market alternatives
- Targeting - ICP and personas
Output: docs/inputs/messaging_positioning.md
Social Media Posts
Generate platform-optimized social content:
/social-posts
Supported platforms:
- LinkedIn (brand and personal accounts)
- Twitter/X (threads and standalone posts)
Process:
- Select platform and account type
- Provide source material (blog post, feature announcement, etc.)
- Skill generates 3-5 variants optimized for each platform's audience
Output: output/social/[platform]-[timestamp].md
Email Sequences
Generate programmatic email sequences:
/email
Current support: Event follow-up sequences (post-conference, post-meeting, post-dinner)
4-email sequence structure:
| Timing | Purpose | |
|---|---|---|
| 1 | Day 0 | Event recall + pain points (no link) |
| 2 | +2 days | Peer social proof + product demo |
| 3 | +6 days | Customer results + resource link |
| 4 | +11 days | Soft close + problem list (no link) |
Key rules:
- Real links only (no placeholders)
- Approved customers only (reads from
testimonials.md) - Programmatic personalization (shared context, not fabricated 1:1 details)
Output: output/email/[sequence-type]-[timestamp].md
Paid Ads Generator
Generate ad copy for Google, Meta, and LinkedIn:
/ads
Uses creative matrix: Topics × Personas × Angles
Supported platforms:
- Google Ads (Search, Display)
- Meta (Facebook, Instagram)
- LinkedIn Ads
Each variant includes:
- Headlines (platform character limits enforced)
- Descriptions
- Image/creative briefs
- Target audience mapping
Output: output/ads/[platform]-[timestamp].md
Sales Deck Builder
Create B2B sales narrative decks using April Dunford's methodology:
/sales-deck
8-step structure:
Phase 1: The Setup (Slides 1-10) - No product mentioned
- Title/Thesis - Bold provocative insight
- TLDR - Executive summary 3-4. Status Quo - Why current approach was rational 5-6. Disruption - What changed 7-8. Alternatives - Why other options fall short 9-10. Perfect World - New purchase criteria
Phase 2: Follow-Through (Slides 11-17) 11. Introduction - Product positioning 12-14. Differentiated Value - Capabilities mapped to criteria 15. Proof - Customer results 16. Objections (optional) 17. The Ask - CTA
Output:
- Markdown outline:
output/decks/[product-name]-sales-deck.md - PPTX file:
output/decks/[product-name]-sales-deck.pptx
Blog Post Generator
Generate SEO and AEO optimized blog posts:
/blog
Supported blog types:
| Type | Best For | Length |
|---|---|---|
| Feature announcement | Release notes, new capability | 800-1,200 words |
| Product launch | New product, major release | 1,200-1,800 words |
| Thought leadership | Opinion piece, contrarian take | 1,500-2,500 words |
| Cookbook/tutorial | How-to guide, integration walkthrough | 1,500-3,000 words |
| Report conversion | Whitepaper/case study → blog | 1,000-1,500 words |
Every blog includes:
- TLDR section (LLM-extractable)
- Metadescription (<160 chars)
- FAQ section (3-5 questions, AEO optimized)
- Schema markup suggestions
- Internal linking recommendations
- Visual callout flags
Tri-publish variants:
- Website/blog (long-tail keywords, schema)
- LinkedIn Pulse (DR 98 domain, LLM citations)
- X article (For You feed optimization)
Output: output/blog/[title-slug]-[timestamp].md
Editorial Calendar
Build a monthly rolling content plan using MKT1 methodology:
/editorial-calendar
Workshop sections:
- Business Context - Goals, revenue levers, GTM motion
- Perceptions - What audience should say about you
- Content Pillars & Audience - Topics, channels, formats
- Capacity - Team size, cadence, backlog
- Product & Market Context - Launches, events, competitive moves
Output artifacts:
- 3-Month Theme Roadmap
- 4-Week Editorial Calendar
- Monthly Refresh Checklist
Output: output/editorial/[month]-editorial-calendar.md
Product Hunt Launch
Generate complete Product Hunt launch package:
/producthunt-launch
Generated assets:
- Product name and tagline
- Description (260 chars)
- Gallery images brief (3 required)
- First comment (detailed walkthrough)
- Hunter outreach template
- 8-week launch timeline with milestones
Output: output/launch/producthunt-[product-name].md
Agents
Asset Reviewer
Reviews generated assets against content guidelines:
/asset-reviewer
Point it at any generated asset in output/ to get compliance scoring.
Ads Auditor
Audits ad performance with health scoring:
/ads-auditor
Requires ad performance data (CSV export from ad platform).
Competitive Intelligence
Analyzes how others market similar products:
/how-they-market
Input: Competitor URL or product name
Output: output/research/competitor-[name]-analysis.md
Configuration
Environment Variables
If using image generation skill (requires MCP):
# .env
ANTHROPIC_API_KEY=your_api_key_here
Brand Guidelines
Customize voice and style in docs/inputs/brand_guidelines.md:
## Voice Principles
- Technical accuracy over marketing fluff
- Show, don't tell (code examples, not promises)
- Developers are sophisticated buyers
## Writing Rules
- Use active voice
- Lead with the insight
- No empty superlatives
Content Guidelines
The framework enforces strict content standards defined in .claude/rules/content-guidelines.md:
Core principles:
- Technical accuracy is non-negotiable
- No marketing fluff or empty superlatives
- Code examples must be real and runnable
- Claims require proof (links, customer quotes, data)
Formatting standards:
- Markdown-first
- Archetypal phrasing for LLM extraction
- Answer-first structure
- Schema markup where applicable
Common Workflows
Launch a New Feature
# 1. Update product brief with new feature
vi docs/inputs/product_brief.md
# 2. Generate feature announcement blog
/blog
# 3. Create social promotion
/social-posts
# 4. Build email sequence
/email
# 5. Update sales deck
/sales-deck
Quarterly Marketing Refresh
# 1. Run messaging workshop
/messaging-positioning
# 2. Build editorial calendar
/editorial-calendar
# 3. Generate ad variants
/ads
# 4. Review all assets
/asset-reviewer
Competitive Response
# 1. Analyze competitor marketing
/how-they-market
# 2. Update competitive intel
vi docs/inputs/competitor_intel.md
# 3. Refresh messaging
/messaging-positioning
# 4. Generate new ad variants
/ads
Advanced Features
Autoresearch (Skill Optimization)
The framework includes a meta-skill that autonomously optimizes other skills:
/autoresearch
How it works:
- Runs target skill multiple times with variations
- Applies binary evals to outputs
- Updates skill definition based on what works
- Commits improvements
Output: output/research/autoresearch-[skill-name]-[timestamp].md
Skill Builder
Create new custom skills:
/skill-builder
Walks through skill creation workflow and generates new skill definition in .claude/skills/.
Troubleshooting
Skills Not Loading
Claude Code:
# Verify claude.md exists
ls -la claude.md
# Verify .claude directory structure
ls -la .claude/skills/
Codex:
# Verify AGENTS.md exists
ls -la AGENTS.md
# Verify .agents directory structure
ls -la .agents/skills/
Missing Product Context
Skills pull from docs/inputs/. If getting generic output:
# Check which templates are filled in
ls -la docs/inputs/
# Minimum required: product_brief.md and target_personas.md
Generated Content Too Generic
Ensure you've completed:
messaging_positioning.md- Provides voice and positioningtestimonials.md- Provides proof pointscompetitor_intel.md- Provides differentiation context
Image Generation Fails
Image skill requires MCP (Model Context Protocol) setup:
# Verify MCP is configured
claude mcp status
# Check API key is set
echo $ANTHROPIC_API_KEY
Best Practices
- Start with messaging workshop - Run
/messaging-positioningbefore generating assets - Keep inputs updated - Treat
docs/inputs/as source of truth - Review generated assets - Always run
/asset-reviewerbefore publishing - Maintain testimonials - Add new customer quotes to
testimonials.mdregularly - Refresh competitive intel - Run
/how-they-marketquarterly - Version control outputs - Commit generated assets for team review
- Use tri-publish strategy - Maximize content ROI with blog → LinkedIn Pulse → X
File Locations
All generated assets go to output/ directory:
output/
├── social/ # Social media posts
├── blog/ # Blog posts and articles
├── email/ # Email sequences
├── ads/ # Ad copy and creative briefs
├── decks/ # Sales and pitch decks
├── images/ # Generated marketing images
└── research/ # Competitive analysis and autoresearch
Template inputs live in docs/inputs/:
docs/inputs/
├── product_brief.md
├── target_personas.md
├── messaging_positioning.md
├── competitor_intel.md
├── testimonials.md
└── brand_guidelines.md