✨ What you get
Each skill is one Markdown file (SKILL.md) that teaches an AI assistant one marketing job from start to finish: what to ask you, which rules and benchmarks to apply, and what the finished document must contain. You ask in plain words. You get a complete .md file, not generic advice.
| You ask | A plain AI chat gives you | With ai-business-skills you get |
|---|
| "Make a marketing plan for my spa" | 500 words of general advice | A full plan: 7 sections, KPIs in 3 scenarios, budget split, weekly timeline, risk table |
| "Write Facebook ads for the new facial" | One generic paragraph | 6 variations (2 for cold, 2 for warm, 2 for hot audiences), each with headline, primary text and CTA |
| "Write this month's report" | A list of numbers | Insight first, then the root cause, actions for the next 48 hours, and next month's plan |
Good for: marketing plans, campaign briefs, ad copy and video scripts, content calendars, ads audits, e-commerce stores on Shopee / TikTok Shop / Lazada, personal brands, and running a marketing team with AI.
Not for: building product code, technical specs or deploying servers.
⚡ Quick start
1. Install (pick one)
Claude Code plugin (easiest, installs all 147 skills)
/plugin marketplace add minhnv0807/ai-business-skills
/plugin install ai-business-skills
Install script
git clone https://github.com/minhnv0807/ai-business-skills.git
cd ai-business-skills
bash install.sh --global # macOS / Linux -> ~/.claude/skills/marketing/
.\install.ps1 -Global # Windows
Another AI tool (ChatGPT, Gemini, Cursor…): see Use it with any AI tool.
2. Describe your business once
> Set up the product marketing context for Luna Spa
The AI interviews you and saves .agents/product-marketing-context.md: product, customers, competitors, positioning, proof and objections. Every skill reads this file first, so you never repeat yourself. For a market outside Vietnam it saves product-marketing-context-global.md instead.
3. Ask for real work
> Plan next month's marketing for Luna Spa
> Write a 30-second TikTok script for the new facial
> Cost per message is 45K VND and ROAS is 1.8x. Audit it and tell me what to fix
> Work backwards: what budget do we need for 200 million VND revenue a month?
Each answer is saved as [skill]-[product]-[YYYYMMDD].md, for example ke-hoach-mkt-spa-luna-20260415.md.
🧭 How it works
flowchart LR
A["💬 You ask<br/>in plain words"] --> B["📇 Read context<br/>.agents/*.md"]
B --> C{"🌏 Which market?"}
C -->|Vietnam| D["🇻🇳 VN skill<br/>skills/vi"]
C -->|Global| E["🌍 Global skill<br/>skills/en"]
D --> F["❓ Ask at most 4 questions<br/>only about what is missing"]
E --> F
F --> G["📏 Apply rules,<br/>benchmarks, legal checks"]
G --> H["📄 Finished .md file"]
| Building block | What it is | Where it lives |
|---|
| Context | Your business on one page, written once | .agents/ in your project |
| Skill | One marketing job, start to finish | skills/vi/, skills/en/, modules/ |
| Agent | A role (strategist, content, design…) that picks the right skills | agents/ |
| Workflow | A fixed chain of skills for a multi-day job or a monthly loop | workflows/, modules/*/workflows/ |
| Knowledge | Background reading to upload into an AI project per role | knowledge/ |
Skills call each other. One request can pull in several skills, in order:
flowchart LR
I20["20 Client intake"] --> I09["09 Customer insight"] & I08["08 Competitor research"] & I10["10 Reverse KPI"]
I09 & I08 & I10 --> P00["00 Marketing plan"]
P00 --> B02["02 Campaign brief"]
B02 --> C05["05 Ad copy"] & C04["04 Video script"] & C01["01 Content calendar"]
Pick a skill by what you need
| If you need… | Start with |
|---|
| 📈 A plan or a budget | 00 plan · 10 reverse KPI · 61 budget |
| ✍️ Content that sells | 01 calendar · 04 video · 05 ads · 37 captions |
| 🎨 Visuals | 30 design master · 41 asset list · 42 image brief |
| 🔍 Ads that stopped working | 21 ads audit · 03 diagnosis · 53 tracking |
| 🛒 Selling on marketplaces (VN) | 76 Shopee / TikTok Shop · 75 KOC · 77 chatbot |
| 🧲 More leads and repeat buyers (VN) | 70 lead magnet · 68 CRO · 69 retention |
| 🎙️ A personal brand | 22 context · 23 strategy · 24 AI avatar |
| 🧠 An AI marketing system | 34 AI Marketing OS · knowledge/ |
🌏 Vietnam or Global
You never switch modes by hand. The skills and agents look at which context file exists:
flowchart TD
S{"Which context file<br/>is in .agents/?"}
S -->|"product-marketing-context.md"| VN["🇻🇳 VN mode<br/>skills/vi"]
S -->|"product-marketing-context-global.md"| GL["🌍 Global mode<br/>skills/en"]
S -->|both| ASK["Asks you one question"]
S -->|none| NEW["Suggests creating one first"]
The same rule applies to personal brands (personal-brand-context.md / -global.md). When both a product and a personal brand context exist, skills 04 (video script) and 05 (ad copy) ask whether to write for sales or for authority.
| Region | Currency | Privacy | Top channels |
|---|
| US | USD | CCPA / state laws | Meta, Google, TikTok, YouTube |
| EU | EUR / GBP | GDPR | Meta, Google, LinkedIn, TikTok |
| SEA | IDR / THB / SGD / PHP | PDPA (varies) | TikTok Shop, Shopee, Lazada, Meta |
| LATAM | BRL / MXN / ARS | LGPD (Brazil) | Meta, TikTok, MercadoLibre, WhatsApp |
Skills with a file per region (variants/01-us.md … 04-latam.md): the foundation context, 03, 10, 11, 14, 17, 18 and 21. More in docs/global-region-guide.md.
👥 Meet the 6 agents
An agent is a role. Tell it the goal and it picks the right skills, in VN or Global mode.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
