AGENTS.md git:20260424.25d034cA

Immutable. This exact content is served forever at /api/v1/blob/885433da1465f933.

# AGENTS.md — Fullstack Marketing Skills

> Huong dan cho bat ky AI agent nao (khong chi Claude) lam viec voi repo nay.

## Tong quan

Repo nay chua **Agent Skills** theo [Agent Skills Specification](https://agentskills.io) — cai dat duoc vao `.agents/skills/` (hoac `.claude/skills/` voi Claude Code).

Repo cung hoat dong nhu **Claude Code Plugin Marketplace** — cai dat bang `/plugin install minhnv0807/fullstack-mkt-skills`.

## Cau truc repo

```
.
├── .claude-plugin/
│   └── marketplace.json         # Claude Code plugin manifest
├── .github/
│   ├── ISSUE_TEMPLATE/           # Issue templates
│   └── PULL_REQUEST_TEMPLATE/    # PR templates
├── skills/
│   └── skill-name/
│       ├── SKILL.md              # Skill definition (required)
│       ├── references/           # Supporting docs (optional)
│       ├── scripts/              # Helper scripts (optional)
│       └── evals/                # Quality tests (optional)
├── references/                   # Shared references across skills
├── workflows/                    # Multi-skill workflows
├── agents/                       # Agent personas/roles
├── examples/                     # Sample outputs
├── AGENTS.md                     # This file
├── CLAUDE.md                     # Claude-specific instructions
├── VERSIONS.md                   # Version tracking
├── CONTRIBUTING.md               # Contribution guide
├── validate-skills.sh            # Spec validator (bash)
└── validate-skills.ps1           # Spec validator (PowerShell)
```

## Yeu cau skill

Moi `SKILL.md` phai co:

### 1. YAML Frontmatter

```yaml
---
name: skill-name                    # Required: 1-64 chars, lowercase + hyphens, match directory
description: "Mo ta cu the..."       # Required: 1-1024 chars, co trigger phrases
metadata:
  version: 1.0.0                    # Optional: semver
  category: strategy | content | performance | operations
license: MIT                        # Optional: default MIT
triggers:                           # Optional: keyword list for auto-activation
  - "trigger 1"
  - "trigger 2"
related:                            # Optional: skill cross-references
  - skill-1
  - skill-2
---
```

### 2. Noi dung

- **Duoi 500 dong** — chi tiet chuyen vao `references/`
- Ngon ngu ro rang, active voice
- Cau truc H2 va H3
- Co "Thu thap thong tin" section (toi da 4 cau)
- Co output template co cau truc
- Co quality checklist

## Foundation skill

**`product-marketing-context`** la skill goc — moi skill khac doc truoc khi hoat dong.

File `.agents/product-marketing-context.md` chua:
- Product overview
- Target audience
- Personas
- Pain points
- Competition
- Differentiation
- Objections
- Customer language
- Brand voice
- Proof points
- Goals

Skill khac kiem tra file nay truoc — neu co, lay thong tin san; neu khong, de xuat tao.

## Cai dat

### Claude Code (khuyen dung)

```bash
# Plugin marketplace
/plugin install minhnv0807/fullstack-mkt-skills

# Hoac clone + install script
git clone https://github.com/minhnv0807/fullstack-mkt-skills.git
cd fullstack-mkt-skills
./install.sh --global
```

### Agent khac (ChatGPT, Gemini, Cursor, v.v.)

- Copy cac file `.md` lam Custom Instructions / System Prompt
- Moi file la 1 prompt doc lap — khong can cai dat dac biet

## Validation

Truoc khi commit, chay:

```bash
./validate-skills.sh
```

Script kiem tra:
- Frontmatter dung spec (name, description, etc.)
- Name khop voi directory
- Duoi 500 dong
- Co trigger phrases trong description

## Versioning

- **Major** (X.0.0): Breaking change (doi frontmatter, doi folder structure)
- **Minor** (1.X.0): Them skill moi hoac them section quan trong
- **Patch** (1.0.X): Sua loi, cap nhat so lieu, chinh syntax

Xem `VERSIONS.md` de theo doi thay doi.

## Git & Contribution

### Branch naming

- `feature/skill-name` — skill moi
- `fix/skill-name` — sua skill hien co
- `docs/...` — cap nhat tai lieu

### Commit format (Conventional Commits)

```
feat: add X skill
fix: correct benchmark in Y skill
docs: update README installation
refactor: restructure Z skill
```

### PR process

1. Fork repo
2. Tao branch tu `master`
3. Chay `validate-skills.sh` truoc khi push
4. Tao PR voi mo ta ro rang
5. Chi ra anh huong (skill nao bi affected, breaking change?)

## Agent guidelines

### Khi dung repo nay

1. **Doc `product-marketing-context` truoc** — neu co file `.agents/product-marketing-context.md`, doc ngay truoc khi lam viec
2. **Doc skill tuong ung** — khi nguoi dung yeu cau cong viec marketing, chon skill phu hop tu `skills/`
3. **Kiem tra version** — doc `VERSIONS.md` 1 lan/session de biet ban cap nhat moi

### Khi update skill

1. Tang version trong `metadata.version`
2. Cap nhat `VERSIONS.md` voi ngay + thay doi
3. Giu frontmatter dung spec
4. Chay validator truoc khi commit

## Tuong thich

| Platform | Ho tro | Cach dung |
|----------|--------|----------|
| Claude Code | Full | `/plugin install` hoac `install.sh --global` |
| Claude Pro | Full | Upload vao Project Knowledge |
| ChatGPT | Partial | Upload `.md` lam Custom GPT config |
| Gemini | Partial | System prompt / context |
| Copilot | Partial | `.github/copilot-instructions.md` |
| Cursor | Partial | `.cursorrules` hoac MDC files |
| Windsurf | Partial | Global rules |
| Agent khac | Partial | Doc `.md` nhu plain text context |

## Resources

- [Agent Skills Spec](https://agentskills.io/specification.md)
- [Claude Code Docs](https://docs.claude.com/en/docs/claude-code)
- [Conventional Commits](https://www.conventionalcommits.org)