ai-business-skills

v2.7.0 — Design Master skill (8 design types: personal brand, business logo, campaign visual, day-to-day marketing, editorial, infographic, web mockup hybrid, quote graphic). Bilingual VN + Global. Zero breaking changes. Changelog

---

⚡ Quick start (30 giây)

git clone https://github.com/minhnv0807/ai-business-skills.git
cd ai-business-skills
bash install.sh --global   # 63 skills → ~/.claude/skills/marketing/

Windows:

.\install.ps1 -Global

Test ngay trong Claude Code:

"Lập kế hoạch marketing cho khóa AI Kiếm Tiền — target 100 học viên đầu tiên trong 30 ngày"

→ Skill 00-ke-hoach-mkt tự kích hoạt, output file .md chi tiết với benchmark VN 2025-2026, KPI 3 kịch bản, budget allocation, weekly timeline, risk matrix.

Muốn cài full stack (build + market) cùng lúc? Xem companion OPA KIT bên dưới.

---

🎯 Khi nào dùng ai-business-skills?

✅ Lập kế hoạch marketing toàn diện — B2B SME VN / Global SMB / agency ✅ Brief campaign — TVC, performance ads, content calendar 30 ngày ✅ Viết copy — Facebook/TikTok ads, script video, email marketing, landing page brief ✅ Personal brand strategy + AI avatar production — founder/coach/creator ✅ Phân tích đối thủ + insight khách hàng + audit ads — diagnostic + 48h action plan ✅ Design master — 8 loại thiết kế (logo, key visual, social post, infographic...) qua prompt-driven workflow ✅ Dropshipping mastery (Global) — niche → product → store → ads → fulfillment → scale

❌ Build product code → dùng companion OPA KIT (opa-pipeline) ❌ Single PRD tech feature → dùng opa-prd ở OPA KIT ❌ Deploy production → dùng opa-deploy ở OPA KIT

---

📦 63 Skills (bilingual VN + Global)

Mỗi skill = 1 file SKILL.md với frontmatter triggers + workflow body. AI agent tự kích hoạt skill khi user nhắc trigger keyword.

Cluster 1: Marketing Core (24 VN + 24 Global)

Foundation skill (product-marketing-context / product-marketing-context-global) đọc 1 lần mỗi project → tránh hỏi lại sản phẩm/audience suốt session. Saves ~70% time.

Cluster 2: Personal Branding (7 VN + 7 Global)

For founder / coach / creator building personal brand with AI avatar.

Cluster 3: Regional flagship (skill 29 — diverges per region)

Cluster 4: Design Master (1 VN + 1 Global) ⭐ NEW v2.7.0

5 Marketing Agents (Universal mode — VN + Global auto-detect)

Agents auto-detect cluster (VN vs Global) via .agents/ context file. No manual config.

15 Workflows (multi-skill chains — 7 VN + 8 Global)

VN workflows (7):

• campaign-launch (14-21 ngày) — 08 → 09 → 00 → 02 → 01+04+05 → 06 → 11
• client-onboard (5-7 ngày, agency) — 20 → 09 → 08 → 10 → 00 → 02 → 01
• monthly-cycle (3-5 ngày) — 13 → 03 → 07 → 10 → 01
• content-production (weekly) — review calendar → 04 → film → 05 → schedule
• personal-brand-launch (30 ngày) — 22 → 23 → 24 → 26 → 27 → 28
• ai-avatar-batch (5 ngày × 5h) — 30 AI Avatar videos, <$2/video
• personal-brand-monthly (3-5 ngày) — 13 → 03 → 07 → review pillars

Global workflows (8): mirrors above + dropshipping-launch-global (14-30 ngày): niche → product validation → store → ads → fulfillment → scale.

---

🌐 Cài đặt theo nền tảng AI

Skills là markdown files với frontmatter — bất kỳ AI agent nào đọc được .md đều dùng được. Dưới đây là setup cho từng platform cụ thể.

Tier 1 — Native skill support (recommended)

1. Claude Code

Cài qua install script:

git clone https://github.com/minhnv0807/ai-business-skills.git
cd ai-business-skills

bash install.sh --global    # → ~/.claude/skills/marketing/
# hoặc
bash install.sh --project   # → .claude/skills/marketing/ trong project hiện tại

Windows PowerShell:

.\install.ps1 -Global

Hoặc cài qua Claude Code plugin marketplace:

/plugin marketplace add minhnv0807/ai-business-skills
/plugin install ai-business-skills

Use ngay sau cài:

> Set up product marketing context cho Luna Spa
> Lập kế hoạch marketing cho tháng 5
> CPMess 45K, ROAS 1.8x — audit và đề xuất tối ưu

2. OpenCode + Ollama Pro Cloud

OpenCode hỗ trợ load skill markdown qua config. Pair với Ollama Cloud Pro (local + cloud routing) cho cost-efficient.

Setup:

# Cài skills vào ~/.claude/skills/marketing/ trước (dùng bash install.sh --global)
# Sau đó reference từ OpenCode config:

Sample ~/.opencode/config.json:

{
  "skills": {
    "root": "~/.claude/skills/marketing",
    "auto_load": ["product-marketing-context", "00-ke-hoach-mkt", "30-thiet-ke-master"]
  },
  "providers": {
    "ollama_cloud": {
      "base_url": "https://ollama.com/api",
      "api_key": "${OLLAMA_API_KEY}"
    }
  },
  "routing": {
    "strategy": ["00-ke-hoach-mkt", "23-personal-brand-strategy", "mkt-strategist"],
    "strategy_model": "qwen2.5:72b",
    "copy":     ["05-copy-quang-cao", "04-script-video", "14-email-marketing"],
    "copy_model": "llama-3.3:70b",
    "analytics": ["03-danh-gia-hieu-suat", "13-phan-tich-du-lieu", "21-audit-ads-performance"],
    "analytics_model": "deepseek-r1"
  }
}

Model backend mapping (recommended):

Cost note: Ollama Cloud Pro $20/mo cho heavy use vs OpenAI/Anthropic API per-token ($50-200/mo cho cùng workload).

3. OpenAI Codex CLI

Reference skill markdown qua --system-prompt-file hoặc copy vào ~/.codex/skills/:

# Cài skills vào ~/.claude/skills/marketing/ trước
codex --system-prompt-file ~/.claude/skills/marketing/00-ke-hoach-mkt/SKILL.md \
      "Lập kế hoạch marketing cho khóa AI Kiếm Tiền"

Skill SKILL.md works as system prompt fragment — frontmatter và body đều được Codex parse.

---

Tier 2 — VS Code + AI extensions

4. VS Code + Cline (recommended cho VS Code users)

Tạo .clinerules ở project root:

# Cline rules — load ai-business-skills

When user mentions marketing tasks, load skills from:
- ~/.claude/skills/marketing/skills/vi/   (VN)
- ~/.claude/skills/marketing/skills/en/   (Global)

Auto-trigger on keywords:
- "lập kế hoạch marketing" / "marketing plan" → 00-ke-hoach-mkt / 00-marketing-plan-global
- "viết copy" / "ad copy" → 05-copy-quang-cao / 05-ad-copy-global
- "thiết kế ảnh" / "design image" → 30-thiet-ke-master / 30-design-master-global

Read foundation first: product-marketing-context/SKILL.md

5. VS Code + Continue.dev

~/.continue/config.json:

{
  "customCommands": [
    {
      "name": "marketing-plan",
      "prompt": "{{{ input }}}\n\nFollow workflow in ~/.claude/skills/marketing/skills/vi/00-ke-hoach-mkt/SKILL.md",
      "description": "Run marketing plan skill"
    }
  ]
}

6. Cursor / Roo Code / GitHub Copilot

Paste skill content vào custom instructions:

• Cursor: .cursorrules ở project root
• Roo Code: System prompt settings
• Copilot: .github/copilot-instructions.md

Mẫu: paste frontmatter + workflow body của 3-5 skill thường dùng (vd product-marketing-context + 00-ke-hoach-mkt + 05-copy-quang-cao + 30-thiet-ke-master).

---

Tier 3 — Other CLIs + community agents

7. Aider, Codeium, Cody

Load skill markdown qua --context hoặc paste vào chat:

aider --read ~/.claude/skills/marketing/skills/vi/00-ke-hoach-mkt/SKILL.md

8. Openclaw, Hermes, community agents

Skills là plain markdown — any agent đọc được .md dùng được. Point agent tới:

~/.claude/skills/marketing/skills/<vi|en>/<skill-name>/SKILL.md

Agent đọc frontmatter triggers + body workflow để output đúng cấu trúc.

---

Tier 4 — Manual (any LLM, no framework)

Không có framework? Vẫn dùng được — copy-paste vào ChatGPT / Claude.ai / Gemini / Bing:

1. Mở skills/vi/00-ke-hoach-mkt/SKILL.md (hoặc skill cần dùng)
2. Copy full content
3. Paste vào chat: "Follow this workflow. My input: [your request]"
4. AI sẽ đọc frontmatter triggers + workflow body và output đúng cấu trúc

Tip: Paste foundation skill (product-marketing-context) trước → trả lời 12 câu setup → AI ghi nhớ context → các skill sau không hỏi lại.

---

🤝 OPA Suite — companion repo

OPA Suite = ai-business-skills (this repo, marketing) + OPA KIT (build pipeline).

OPA KIT — 8 tech skills cho build pipeline

• opa-prd — PRD authoring 3 modes (Product full / Creative 1-page / Lesson module)
• opa-pipeline — 6-phase end-to-end shipping (CEO/PM/Engineer/Reviewer modes)
• opa-tracker — progress tracking + token cost + model recommendation
• opa-deploy — Coolify-first deploy với manual confirm gate
• opa-diagram — Mermaid diagrams (workflow, journey, funnel, C4, ERD, state)
• opa-judge — quality gate review
• opa-para-pipeline — parallel multi-feature shipping

Workflow chain typical

OPA KIT (build)                  →    ai-business-skills (market)
─────────────────────────             ─────────────────────────
opa-prd → opa-pipeline → ship    →    00-ke-hoach-mkt
                                 →    02-brief-chien-dich
                                 →    30-thiet-ke-master  (key visual + social posts)
                                 →    campaign-launch workflow (14-21 ngày)
                                 →    03-danh-gia-hieu-suat (audit sau 30 ngày)

Cài cả 2 cùng lúc

git clone https://github.com/minhnv0807/opa-kit.git
cd opa-kit && bash install-opa-suite.sh

Script tự install OPA KIT + ai-business-skills. Xem references/companion-skills.md trong OPA KIT cho full ecosystem map.

🧬 Compatible with Anthropic knowledge-work-plugins

ai-business-skills follows Anthropic's knowledge-work-plugins structure (.mcp.json connectors, CONNECTORS.md placeholders, argument-hint slash commands). Compatible với Cowork ecosystem + Claude Code marketplace.

Companion repo OPA KIT also Anthropic-aligned cho consistent OPA Suite UX.

---

🛠️ Architecture — how skills work

---
name: 00-ke-hoach-mkt
description: Mô tả ngắn — dùng để AI quyết định có kích hoạt không
category: strategy
triggers:
  - "lập kế hoạch marketing"
  - "marketing plan"
  - "kế hoạch tháng"
output: file .md với cấu trúc 7 sections + KPI 3 scenarios
related: [08-nghien-cuu-doi-thu, 09-insight-khach-hang, 10-tinh-kpi-nguoc]
---

# Skill Title

## Thu thập thông tin (grill pattern)
[Hỏi tối đa 4 câu để fill blank — không hỏi nếu đã có context]

## Nguyên tắc
[Rules quan trọng: insight trước số liệu, benchmark VN, không generic]

## Cấu trúc kết quả
[Template output chi tiết — sections, tables, scenarios]

## Checklist chất lượng
[Quality gates trước khi giao file .md]

Skill chain — nhiều skill tự gọi nhau:

• 20-brief-client-intake → 09 → 08 → 10 → 00 (full client onboarding)
• 00-ke-hoach-mkt → 08 → 09 → 10 (research before planning)
• 02-brief-chien-dich → 05 + 04 + 01 (campaign breaks into content)
• 30-thiet-ke-master reads context từ 22-personal-brand-context hoặc product-marketing-context để compose prompt đúng brand voice

Personal Brand Mode auto-detect (skill 04, 05):

• .agents/product-marketing-context.md only → Mode A (sales/conversion)
• .agents/personal-brand-context.md only → Mode B (authority/trust)
• Both → skill hỏi 1 câu trước khi viết
• Neither → suggest tạo context file

---

🌍 Bilingual coverage

Global cluster covers 4 regions with per-region variants (currency, privacy law, channels):

Skills with explicit per-region variants (variants/01-us.md, 02-eu.md, 03-sea.md, 04-latam.md): 03, 10, 11, 14, 17, 18, 21, foundation.

---

📊 VN Benchmarks 2025-2026 (quick ref)

Full benchmarks by industry: skills/vi/references/ · Global benchmarks: skills/en/references/

---

🤝 Contributing

See CONTRIBUTING.md.

git checkout -b feature/new-skill
./validate-skills.sh             # validate frontmatter + structure
git commit -m "feat(skill): add new-skill"

Contributions welcome — bilingual VN/EN preferred, single language accepted. Add skill to .claude-plugin/marketplace.json plugins list.

---

💖 Support

Free + MIT-licensed. Saving you hours of marketing work? Support helps fund:

• New region variants (APAC v2.8.0, India, MENA roadmap)
• More industry-specific skills (SaaS, e-commerce verticals)
• Bilingual docs + video tutorials

Or: ⭐ star this repo · 🐛 Report bugs · 🤝 Submit PRs · 📣 Share with @OverPowersAgency

---

📜 License

MIT — free to use, modify, distribute. See LICENSE.

---