ai-business-skills

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

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

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

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

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.