@hungvv/super-ads-skills 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/README.md +42 -2
  2. package/bin/super-ads-skills.js +2 -0
  3. package/dist/cli.js +654 -0
  4. package/package.json +54 -4
  5. package/scripts/install-skills.ps1 +38 -0
  6. package/scripts/install-skills.sh +43 -0
  7. package/skills/README.md +59 -0
  8. package/skills/adspro-to-superads/SKILL.md +816 -0
  9. package/skills/adspro-to-superads/references/api-mapping.md +331 -0
  10. package/skills/adspro-to-superads/references/config-template.md +485 -0
  11. package/skills/adspro-to-superads/references/migration-pitfalls.md +201 -0
  12. package/skills/adspro-to-superads/references/troubleshooting.md +221 -0
  13. package/skills/adspro-to-superads/references/verification.md +168 -0
  14. package/skills/adspro-to-superads/references/wrapper-template.md +567 -0
  15. package/skills/super-ads-ab-test/SKILL.md +91 -0
  16. package/skills/super-ads-ab-test/references/firebase-handoff-template.md +54 -0
  17. package/skills/super-ads-adb-test/SKILL.md +107 -0
  18. package/skills/super-ads-adb-test/references/log-assertions.md +53 -0
  19. package/skills/super-ads-adb-test/references/sample-app-notes.md +27 -0
  20. package/skills/super-ads-adb-test/references/scenario-format.md +53 -0
  21. package/skills/super-ads-adb-test/references/scenarios-sample.md +45 -0
  22. package/skills/super-ads-add-placement/SKILL.md +128 -0
  23. package/skills/super-ads-add-placement/references/call-site-snippets.md +90 -0
  24. package/skills/super-ads-config/SKILL.md +132 -0
  25. package/skills/super-ads-config/references/patch-examples.md +162 -0
  26. package/skills/super-ads-debug/SKILL.md +109 -0
  27. package/skills/super-ads-debug/references/error-codes.md +112 -0
  28. package/skills/super-ads-debug/references/logging-setup.md +157 -0
  29. package/skills/super-ads-debug/references/symptom-playbook.md +59 -0
  30. package/skills/super-ads-debug-override/SKILL.md +123 -0
  31. package/skills/super-ads-debug-override/references/hook-implementation.md +73 -0
  32. package/skills/super-ads-integrate/SKILL.md +115 -0
  33. package/skills/super-ads-integrate/references/application-setup.md +61 -0
  34. package/skills/super-ads-integrate/references/gradle-setup.md +89 -0
  35. package/skills/super-ads-release-check/SKILL.md +92 -0
  36. package/skills/super-ads-release-check/references/firebase-ab-checklist.md +94 -0
  37. package/skills/super-ads-release-check/references/ga4-custom-definitions.md +34 -0
  38. package/skills/super-ads-show-rate/SKILL.md +92 -0
  39. package/skills/super-ads-show-rate/references/collect-snippet.md +59 -0
  40. package/skills/super-ads-show-rate/references/metrics.md +55 -0
package/README.md CHANGED
@@ -1,3 +1,43 @@
1
- # Temporary Holding Version
1
+ # SuperAds Skills
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Bộ skill SuperAds cho AI agent (Claude Code, Cursor, Codex, Antigravity), có CLI cài riêng. Danh mục và cây chọn skill: [skills/README.md](skills/README.md).
4
+
5
+ ## Cài (một lệnh)
6
+
7
+ ```bash
8
+ cd tools/super-ads-skills && npm ci && npm run build && npm link && super-ads-skills install
9
+ ```
10
+
11
+ `install` cài **tất cả skill cho tất cả agent**, ở mức global, bằng symlink về một bản chung `~/.local/share/super-ads-skills/skills`. Không có câu hỏi nào.
12
+
13
+ | Agent | Thư mục skill |
14
+ |---|---|
15
+ | Claude Code | `~/.claude/skills` |
16
+ | Cursor | `~/.cursor/skills` |
17
+ | Codex | `~/.agents/skills` |
18
+ | Antigravity | `~/.gemini/config/skills`, `~/.gemini/antigravity-ide/builtin/skills` |
19
+
20
+ ## Update (một lệnh)
21
+
22
+ ```bash
23
+ git pull && super-ads-skills update
24
+ ```
25
+
26
+ Nhờ symlink, skill sửa trong clone có hiệu lực ngay cho mọi agent; `update` còn làm mới bản chung, ghi version vào manifest và gỡ skill đã bị loại khỏi bộ. Skill bị sửa tay trong thư mục agent được giữ nguyên, trừ khi thêm `--force`.
27
+
28
+ ## Lệnh khác
29
+
30
+ ```bash
31
+ super-ads-skills list # trạng thái từng skill
32
+ super-ads-skills remove [skill...] # gỡ (không tên = gỡ hết)
33
+ ```
34
+
35
+ Cờ tuỳ chọn, chỉ khi cần: `--agent claude,cursor`, `--project` (cài vào thư mục hiện tại), `--copy` (copy thay vì symlink), `--force`, `--dry-run`. Biến môi trường `SUPER_ADS_SKILLS_STORE` đổi nơi đặt bản chung.
36
+
37
+ Máy không có Node: `bash scripts/install-skills.sh` (Windows: `scripts/install-skills.ps1`). Cùng kết quả, chạy lại là update, không có `list`/`remove`.
38
+
39
+ ## Kết nối MCP
40
+ Skill sửa config chỉ qua MCP `super-ads`: xem [../ai_agent_tools/README.md](../ai_agent_tools/README.md) mục 2.
41
+
42
+ ## Phát triển
43
+ Thêm skill, quy ước version, kiểm tra: [docs/AUTHORING.md](docs/AUTHORING.md).
package/bin/super-ads-skills.js ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ import '../dist/cli.js'