@nguyenphp/antigravity-marketing 1.0.0

package/README.md

@@ -0,0 +1,186 @@
+# 🚀 Antigravity Marketing Kit
+
+> **24 marketing skills, 4 agents, and 4 workflows** for AI-powered marketing with Gemini CLI.
+
+## 📋 Table of Contents
+
+- [Introduction](#-introduction)
+- [Skills](#-skills)
+- [Agents](#-agents)
+- [Workflows](#-workflows)
+- [Installation](#-installation)
+- [Usage](#-usage)
+- [Contributing](#-contributing)
+- [License](#-license)
+
+## 🎯 Introduction
+
+Antigravity Marketing Kit is a comprehensive collection of marketing-focused skills, agents, and workflows designed to supercharge your AI-assisted marketing efforts.
+
+> **Based on [Antigravity Kit](https://github.com/vudovn/antigravity-kit)** - the original CLI toolkit for AI agent skills.
+
+This toolkit includes:
+- **Skills** - Marketing domain expertise (Content, SEO, Social Media, Growth...)
+- **Agents** - Specialized AI agents for marketing tasks
+- **Workflows** - Step-by-step procedures for common marketing tasks
+
+## 🙏 Credits
+
+This project is built upon and includes skills from:
+
+- 🚀 **[Antigravity Kit](https://github.com/vudovn/antigravity-kit)** - Base CLI structure and core skills
+- 🎨 **[UI UX Pro Max](https://ui-ux-pro-max-skill.nextlevelbuilder.io/)** - Design intelligence skills (`ui-ux-pro-max`, `frontend-design`, `tailwind-patterns`)
+- 🛠️ **[ClaudeKit](https://claudekit.cc/)** - Production-ready skills (`seo-fundamentals`, `documentation-templates`)
+
+## 🧠 Skills (17)
+
+### Content & Creative
+| Skill | Description |
+|-------|-------------|
+| `content-marketing` | Content strategy, copywriting, storytelling |
+| `branding-expert` | Brand identity, voice & tone, style guides |
+| `video-marketing` | Video strategy, YouTube SEO, short-form content |
+
+### Growth & Acquisition
+| Skill | Description |
+|-------|-------------|
+| `growth-hacking` | Viral loops, referral programs, AARRR framework |
+| `ppc-advertising` | Google Ads, Meta Ads, campaign optimization |
+| `influencer-marketing` | Influencer outreach, KOL partnerships |
+| `affiliate-marketing` | Affiliate programs, partner networks |
+
+### Channels
+| Skill | Description |
+|-------|-------------|
+| `social-media-expert` | Platform strategies (FB, IG, TikTok, LinkedIn) |
+| `email-marketing` | Campaigns, sequences, automation, newsletters |
+
+### Optimization & Analytics
+| Skill | Description |
+|-------|-------------|
+| `seo-fundamentals` | SEO best practices, E-E-A-T, Core Web Vitals |
+| `analytics-marketing` | KPIs, attribution, GA4, dashboards |
+| `conversion-optimization` | CRO, A/B testing, landing pages |
+| `marketing-automation` | Lead nurturing, workflows, segmentation |
+
+### Design & Development
+| Skill | Description |
+|-------|-------------|
+| `ui-ux-pro-max` | Design intelligence for marketing |
+| `frontend-design` | Landing page & web design |
+| `tailwind-patterns` | Utility-first CSS patterns |
+| `documentation-templates` | Marketing documentation templates |
+
+## 🤖 Agents (4)
+
+| Agent | Description |
+|-------|-------------|
+| `marketing-strategist` | Overall marketing strategy orchestrator |
+| `content-creator` | Content creation specialist |
+| `growth-specialist` | Growth hacking specialist |
+| `analytics-specialist` | Data analysis and insights |
+
+## 🔄 Workflows (4)
+
+| Command | Description |
+|---------|-------------|
+| `/campaign` | Create marketing campaign |
+| `/content` | Content creation workflow |
+| `/analyze` | Marketing analytics workflow |
+| `/optimize` | Conversion optimization workflow |
+
+## 📦 Installation
+
+### Install Global (Recommended)
+
+```bash
+# Install globally
+npm install -g @nguyenphp/antigravity-marketing
+
+# Navigate to your project
+cd your-project
+
+# Install .agent folder
+ag-marketing-kit init
+
+# Update to latest version
+ag-marketing-kit update
+
+# Check status
+ag-marketing-kit status
+
+# List all skills
+ag-marketing-kit list
+```
+
+### Using npx (No Install)
+
+```bash
+# Navigate to your project
+cd your-project
+
+# Install .agent folder
+npx @nguyenphp/antigravity-marketing init
+```
+
+### CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `ag-marketing-kit init` | Install .agent folder |
+| `ag-marketing-kit update` | Update to latest version |
+| `ag-marketing-kit status` | Check installation status |
+| `ag-marketing-kit list` | List all available skills |
+
+#### Command Options
+
+```bash
+# init options
+ag-marketing-kit init [options]
+  -f, --force          # Overwrite if folder exists
+  -p, --path <dir>     # Path to project directory
+  -b, --branch <name>  # Select repository branch
+
+# update options
+ag-marketing-kit update [options]
+  -f, --force          # Skip confirmation
+  -p, --path <dir>     # Path to project directory
+  -b, --branch <name>  # Select repository branch
+```
+
+## 🚀 Usage
+
+### Skills
+
+Skills are automatically detected and used by Gemini CLI based on context.
+
+### Workflows
+
+Invoke workflows with slash commands:
+
+```
+/campaign - Start a marketing campaign workflow
+/content - Create content with guidance
+/analyze - Analyze marketing metrics
+/optimize - Run conversion optimization
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+### Adding a New Skill
+
+1. Create folder in `templates/.agent/skills/your-skill/`
+2. Add `SKILL.md` with YAML frontmatter and content
+3. Submit PR
+
+### Adding a New Workflow
+
+1. Create file in `templates/.agent/workflows/your-workflow.md`
+2. Add description frontmatter and steps
+3. Submit PR
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/bin/index.js

@@ -0,0 +1,340 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { downloadTemplate } from 'giget';
+import path from 'path';
+import fs from 'fs';
+import readline from 'readline';
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+const REPO = 'github:nguyenphp/antigravity-marketing';
+const TEMPLATES_FOLDER = 'templates';
+const AGENT_FOLDER = '.agent';
+const TEMP_FOLDER = '.temp_ag_marketing_kit';
+
+// ============================================================================
+// UTILITIES
+// ============================================================================
+
+/**
+ * Display ASCII banner
+ */
+const showBanner = () => {
+    console.log(chalk.magentaBright(`
+    ╔══════════════════════════════════════════╗
+    ║   🚀 ANTIGRAVITY MARKETING KIT CLI 🚀    ║
+    ║        Marketing Skills for AI           ║
+    ╚══════════════════════════════════════════╝
+    `));
+};
+
+/**
+ * Ask user for confirmation
+ * @param {string} question - Question to ask
+ * @returns {Promise<boolean>}
+ */
+const confirm = (question) => {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+
+    return new Promise((resolve) => {
+        rl.question(chalk.yellow(`${question} (y/N): `), (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+};
+
+/**
+ * Clean up temporary directory
+ * @param {string} tempDir - Temp directory path
+ */
+const cleanup = (tempDir) => {
+    if (fs.existsSync(tempDir)) {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+};
+
+/**
+ * Copy .agent folder from temp to destination
+ * @param {string} tempDir - Temp directory
+ * @param {string} destDir - Destination directory
+ */
+const copyAgentFolder = (tempDir, destDir) => {
+    const sourceAgent = path.join(tempDir, TEMPLATES_FOLDER, AGENT_FOLDER);
+
+    if (!fs.existsSync(sourceAgent)) {
+        throw new Error(`Could not find ${TEMPLATES_FOLDER}/${AGENT_FOLDER} folder in source repository!`);
+    }
+
+    fs.cpSync(sourceAgent, destDir, { recursive: true });
+};
+
+/**
+ * Update .gitignore to include .agent folder
+ * @param {string} targetDir - Target project directory
+ * @returns {boolean} - True if .gitignore was updated
+ */
+const updateGitignore = (targetDir) => {
+    const gitignorePath = path.join(targetDir, '.gitignore');
+    const entryToAdd = AGENT_FOLDER;
+
+    // Check if .gitignore exists
+    if (fs.existsSync(gitignorePath)) {
+        const content = fs.readFileSync(gitignorePath, 'utf-8');
+        const lines = content.split(/\r?\n/);
+
+        // Check if .agent is already in .gitignore
+        const hasEntry = lines.some(line =>
+            line.trim() === entryToAdd ||
+            line.trim() === `${entryToAdd}/` ||
+            line.trim() === `/${entryToAdd}` ||
+            line.trim() === `/${entryToAdd}/`
+        );
+
+        if (!hasEntry) {
+            // Add .agent to .gitignore
+            const newContent = content.endsWith('\n')
+                ? `${content}${entryToAdd}\n`
+                : `${content}\n${entryToAdd}\n`;
+            fs.writeFileSync(gitignorePath, newContent);
+            return true;
+        }
+    } else {
+        // Create new .gitignore with .agent
+        fs.writeFileSync(gitignorePath, `${entryToAdd}\n`);
+        return true;
+    }
+
+    return false;
+};
+
+// ============================================================================
+// COMMANDS
+// ============================================================================
+
+/**
+ * Initialize .agent folder in project
+ */
+const initCommand = async (options) => {
+    showBanner();
+
+    const targetDir = path.resolve(options.path || process.cwd());
+    const tempDir = path.join(targetDir, TEMP_FOLDER);
+    const agentDir = path.join(targetDir, AGENT_FOLDER);
+
+    // Check if .agent already exists
+    if (fs.existsSync(agentDir)) {
+        if (!options.force) {
+            console.log(chalk.yellow(`⚠️  Folder ${AGENT_FOLDER} already exists at: ${agentDir}`));
+            const shouldOverwrite = await confirm('Do you want to overwrite it?');
+
+            if (!shouldOverwrite) {
+                console.log(chalk.gray('Operation cancelled.'));
+                process.exit(0);
+            }
+        }
+        console.log(chalk.gray(`Overwriting ${AGENT_FOLDER} folder...`));
+    }
+
+    const spinner = ora({
+        text: 'Downloading marketing skills...',
+        color: 'magenta',
+    }).start();
+
+    try {
+        // Download repository using giget
+        const repoSource = options.branch ? `${REPO}#${options.branch}` : REPO;
+        await downloadTemplate(repoSource, {
+            dir: tempDir,
+            force: true,
+        });
+
+        spinner.text = 'Installing marketing skills...';
+
+        // Copy .agent folder
+        copyAgentFolder(tempDir, agentDir);
+
+        // Update .gitignore
+        const gitignoreUpdated = updateGitignore(targetDir);
+
+        // Cleanup
+        cleanup(tempDir);
+
+        spinner.succeed(chalk.green('Marketing Kit installed successfully!'));
+
+        // Success message
+        console.log(chalk.gray('\n────────────────────────────────────────'));
+        console.log(chalk.white('📁 Result:'));
+        console.log(`   ${chalk.cyan(AGENT_FOLDER)} → ${chalk.gray(agentDir)}`);
+        if (gitignoreUpdated) {
+            console.log(`   ${chalk.cyan('.gitignore')} → Added ${chalk.yellow(AGENT_FOLDER)}`);
+        }
+        console.log(chalk.gray('────────────────────────────────────────'));
+
+        // Show skills summary
+        console.log(chalk.white('\n📦 Included:'));
+        console.log(chalk.magenta('   • 17 Marketing Skills'));
+        console.log(chalk.magenta('   • 4 Specialized Agents'));
+        console.log(chalk.magenta('   • 4 Workflow Commands'));
+        console.log(chalk.gray('────────────────────────────────────────'));
+        console.log(chalk.green('\n🎉 Happy marketing!\n'));
+    } catch (error) {
+        spinner.fail(chalk.red(`❌ Error: ${error.message}`));
+        cleanup(tempDir);
+        process.exit(1);
+    }
+};
+
+/**
+ * Update existing .agent folder
+ */
+const updateCommand = async (options) => {
+    showBanner();
+
+    const targetDir = path.resolve(options.path || process.cwd());
+    const agentDir = path.join(targetDir, AGENT_FOLDER);
+
+    // Check if .agent exists
+    if (!fs.existsSync(agentDir)) {
+        console.log(chalk.red(`❌ Could not find ${AGENT_FOLDER} folder at: ${targetDir}`));
+        console.log(chalk.yellow(`💡 Tip: Run ${chalk.cyan('ag-marketing-kit init')} to install first.`));
+        process.exit(1);
+    }
+
+    if (!options.force) {
+        console.log(chalk.yellow(`⚠️  Update will overwrite the entire ${AGENT_FOLDER} folder`));
+        const shouldUpdate = await confirm('Are you sure you want to continue?');
+
+        if (!shouldUpdate) {
+            console.log(chalk.gray('Operation cancelled.'));
+            process.exit(0);
+        }
+    }
+
+    // Call init with force option
+    await initCommand({ ...options, force: true });
+};
+
+/**
+ * Show status of .agent folder
+ */
+const statusCommand = (options) => {
+    const targetDir = path.resolve(options.path || process.cwd());
+    const agentDir = path.join(targetDir, AGENT_FOLDER);
+
+    console.log(chalk.magentaBright('\n📊 Antigravity Marketing Kit Status\n'));
+
+    if (fs.existsSync(agentDir)) {
+        const stats = fs.statSync(agentDir);
+
+        // Count skills, agents, workflows
+        const skillsDir = path.join(agentDir, 'skills');
+        const agentsDir = path.join(agentDir, 'agents');
+        const workflowsDir = path.join(agentDir, 'workflows');
+
+        const skillCount = fs.existsSync(skillsDir) ? fs.readdirSync(skillsDir).length : 0;
+        const agentCount = fs.existsSync(agentsDir) ? fs.readdirSync(agentsDir).length : 0;
+        const workflowCount = fs.existsSync(workflowsDir) ? fs.readdirSync(workflowsDir).length : 0;
+
+        console.log(chalk.green('✅ Installed'));
+        console.log(chalk.gray('────────────────────────────────────────'));
+        console.log(`📁 Path:      ${chalk.cyan(agentDir)}`);
+        console.log(`📅 Modified:  ${chalk.gray(stats.mtime.toLocaleString('en-US'))}`);
+        console.log(`🧠 Skills:    ${chalk.yellow(skillCount)}`);
+        console.log(`🤖 Agents:    ${chalk.yellow(agentCount)}`);
+        console.log(`🔄 Workflows: ${chalk.yellow(workflowCount)}`);
+        console.log(chalk.gray('────────────────────────────────────────\n'));
+    } else {
+        console.log(chalk.red('❌ Not installed'));
+        console.log(chalk.yellow(`💡 Run ${chalk.cyan('ag-marketing-kit init')} to install.\n`));
+    }
+};
+
+/**
+ * List all available skills
+ */
+const listCommand = (options) => {
+    const targetDir = path.resolve(options.path || process.cwd());
+    const agentDir = path.join(targetDir, AGENT_FOLDER);
+
+    console.log(chalk.magentaBright('\n📋 Available Marketing Skills\n'));
+
+    if (!fs.existsSync(agentDir)) {
+        console.log(chalk.red('❌ Marketing Kit not installed'));
+        console.log(chalk.yellow(`💡 Run ${chalk.cyan('ag-marketing-kit init')} first.\n`));
+        process.exit(1);
+    }
+
+    const skillsDir = path.join(agentDir, 'skills');
+    if (fs.existsSync(skillsDir)) {
+        const skills = fs.readdirSync(skillsDir).filter(f =>
+            fs.statSync(path.join(skillsDir, f)).isDirectory()
+        );
+
+        console.log(chalk.gray('────────────────────────────────────────'));
+        skills.forEach(skill => {
+            console.log(`   ${chalk.magenta('•')} ${chalk.white(skill)}`);
+        });
+        console.log(chalk.gray('────────────────────────────────────────'));
+        console.log(chalk.gray(`\nTotal: ${skills.length} skills\n`));
+    }
+};
+
+// ============================================================================
+// CLI DEFINITION
+// ============================================================================
+
+const program = new Command();
+
+program
+    .name('ag-marketing-kit')
+    .description('CLI tool to install and manage Antigravity Marketing Kit')
+    .version('1.0.0', '-v, --version', 'Display version number');
+
+// Command: init
+program
+    .command('init')
+    .description('Install marketing skills into your project')
+    .option('-f, --force', 'Overwrite if folder already exists', false)
+    .option('-p, --path <dir>', 'Path to the project directory', process.cwd())
+    .option('-b, --branch <name>', 'Select repository branch')
+    .action(initCommand);
+
+// Command: update
+program
+    .command('update')
+    .description('Update marketing skills to the latest version')
+    .option('-f, --force', 'Skip confirmation prompt', false)
+    .option('-p, --path <dir>', 'Path to the project directory', process.cwd())
+    .option('-b, --branch <name>', 'Select repository branch')
+    .action(updateCommand);
+
+// Command: status
+program
+    .command('status')
+    .description('Check installation status')
+    .option('-p, --path <dir>', 'Path to the project directory', process.cwd())
+    .action(statusCommand);
+
+// Command: list
+program
+    .command('list')
+    .description('List all available skills')
+    .option('-p, --path <dir>', 'Path to the project directory', process.cwd())
+    .action(listCommand);
+
+// Parse arguments
+program.parse(process.argv);
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@nguyenphp/antigravity-marketing",
+  "version": "1.0.0",
+  "description": "Marketing-focused AI agent skills kit for Gemini CLI",
+  "main": "bin/index.js",
+  "type": "module",
+  "bin": {
+    "ag-marketing-kit": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "templates"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nguyenphp/antigravity-marketing.git"
+  },
+  "homepage": "https://github.com/nguyenphp/antigravity-marketing#readme",
+  "bugs": {
+    "url": "https://github.com/nguyenphp/antigravity-marketing/issues"
+  },
+  "keywords": [
+    "antigravity",
+    "marketing",
+    "cli",
+    "ai",
+    "agent",
+    "gemini",
+    "skills",
+    "seo",
+    "content-marketing",
+    "social-media",
+    "growth-hacking"
+  ],
+  "author": "NguyenPHP",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.3.3",
+    "giget": "^2.0.0",
+    "ora": "^8.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/.agent/agents/analytics-specialist.md

@@ -0,0 +1,67 @@
+---
+description: Marketing data analysis and performance insights specialist.
+---
+
+# Analytics Specialist Agent
+
+You are an Analytics Specialist agent - a data scientist focused on marketing analytics who turns data into actionable insights.
+
+## Core Capabilities
+
+- Set up tracking and attribution
+- Analyze marketing performance
+- Build dashboards and reports
+- Identify optimization opportunities
+- Forecast and model outcomes
+- A/B test analysis
+
+## When to Use
+
+Use this agent when you need to:
+- Analyze marketing performance
+- Set up analytics tracking
+- Build marketing dashboards
+- Calculate ROI and attribution
+- Interpret test results
+- Create performance reports
+
+## Process
+
+1. **Define**: Clarify questions and goals
+2. **Collect**: Ensure proper tracking
+3. **Analyze**: Process and explore data
+4. **Insight**: Find actionable patterns
+5. **Recommend**: Suggest actions
+6. **Report**: Communicate findings
+
+## Key Metrics Framework
+
+### Acquisition Metrics
+- CAC, CPL, CPC, CPM
+- Traffic sources
+- Conversion rates
+
+### Engagement Metrics
+- Bounce rate
+- Session duration
+- Pages per session
+
+### Revenue Metrics
+- LTV, ROAS, MER
+- Attribution by channel
+- Cohort analysis
+
+## Output Formats
+
+- Performance reports
+- Dashboards
+- Attribution analysis
+- Test results
+- Forecasts
+- Recommendations
+
+## Skills Used
+
+- analytics-marketing
+- growth-hacking
+- conversion-optimization

package/templates/.agent/agents/content-creator.md

@@ -0,0 +1,65 @@
+---
+description: Content creation specialist for all marketing content types.
+---
+
+# Content Creator Agent
+
+You are a Content Creator agent - an expert content marketer who can create compelling content across all formats and platforms.
+
+## Core Capabilities
+
+- Write engaging blog posts and articles
+- Create social media content calendars
+- Develop email copy and sequences
+- Write landing page copy
+- Script video content
+- Create lead magnets and whitepapers
+
+## When to Use
+
+Use this agent when you need to:
+- Create any type of marketing content
+- Write copy for campaigns
+- Develop content calendars
+- Build email sequences
+- Create content for specific audiences
+
+## Process
+
+1. **Brief**: Understand goals, audience, and constraints
+2. **Research**: Topic research, keyword analysis
+3. **Outline**: Structure and key points
+4. **Draft**: Write initial content
+5. **Optimize**: SEO, readability, conversion
+6. **Review**: Final polish
+
+## Output Formats
+
+- Blog posts
+- Social media posts
+- Email copy
+- Landing page copy
+- Video scripts
+- Lead magnets
+
+## Content Guidelines
+
+### Voice Principles
+- Clear and concise
+- Benefit-focused
+- Action-oriented
+- Audience-appropriate
+
+### SEO Integration
+- Keyword research
+- On-page optimization
+- Internal linking
+- Meta descriptions
+
+## Skills Used
+
+- content-marketing
+- seo-fundamentals
+- social-media-expert
+- email-marketing
+- branding-expert