1仕組みと動作原理
50個の独立したスキル（skills/<name>/SKILL.md）のコレクションであり、共有コンテキストによって統合されています。product-marketing が基盤となり、他の全スキルは作業着手前にこのスキルが生成したプロダクト／ターゲット層／ポジショニングのドキュメントを読み込みます。
README.md
Skills reference each other and build on shared context. The `product-marketing` skill is the foundation — every other skill checks it first to understand your product, audience, and positioning before doing anything.
実体として .agents/product-marketing.md の単一ファイルに書き出されます（product-marketing の Workflow Step 1 で存在有無を検証し、コードベースから V1 を自動ドラフトするオプションを提供）。
各スキルはすべて純粋な Markdown 指示（skills/ 配下には実行ファイルなし）であり、ドメインエキスパート方式のチェックリストと出力構造規律によって実装されています。知識密度の高いパートは references/ に分割され、オンデマンドでロードされます。
skills/cro/SKILL.md
You are a conversion rate optimization expert. Your goal is to analyze marketing pages and provide actionable recommendations to improve conversion rates.
50個の SKILL.md は合計 15,196 行で、検証の結果 500 行を超えるものは皆無でした（AGENTS.md で独自に定めた上限に準拠）。さらに 178 個の references/ ファイルが詳細を保持しています。
実際の実行レイヤーは tools/clis に集約されています。64個の依存関係ゼロの単一ファイル Node CLI で構成され、それぞれ環境変数から認証情報を読み取り、fetch で各ベンダーの API を呼び出します。リクエストを送信せず表示のみ行う --dry-run を標準搭載しています。
tools/clis/ga4.js
if (args['dry-run']) { return { _dry_run: true, method, url: `${baseUrl}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined } }
実測における3つの統計が一致：'process.env'、'await fetch'、'dry-run' の grep -l 該当件数はいずれも64ファイル（網羅率100%）。認証情報が欠落している場合は即座にエラー終了します（例: 'GA4_ACCESS_TOKEN environment variable required'）。
ツールのナレッジはレジストリとツール別統合ガイドの2層で構成されています。REGISTRY.md がインデックスと機能マトリクスを提供し、tools/integrations/*.md がエンドポイント、認証、一般的な操作手順をカバーします。
tools/REGISTRY.md
Quick reference for AI agents to discover tool capabilities and integration methods.
tools/integrations/ 配下に 95 件のガイドが存在することを確認済み。REGISTRY の表には各ツールの API/MCP/CLI/SDK 対応状況が明記されています。
各スキルには独自の評価テストケース（evals/evals.json）が付属しており、期待される出力とアサーション検証項目がハードコードされています。コンテンツ系スキルとしては極めて珍しいテスト資産です。
skills/cro/evals/evals.json
Checks for product-marketing.md
50個のスキルそれぞれに1つずつ存在（find -name evals.json = 50）。テストケースには prompt、expected_output、assertions 配列が含まれます（例: 出力に Quick Wins / High-Impact Changes / Test Ideas の3セクションを含むことを義務付け）。
配布とマニフェストの整合性は自動化されています。CI は SKILL.md 変更時に変更マトリクスに基づいて個別検証を行い、main への push 時に marketplace.json / plugin.json / README を自動同期します。
.github/workflows/validate-skill.yml
uses: Flash-Brew-Digital/validate-skill@v1
sync-skills.yml が Coreybot 名義で 'chore: sync skills with marketplace.json, plugin.json, and README' を自動コミットします。ローカルには validate-skills.sh（独自仕様チェック）と validate-skills-official.sh（公式 skills-ref リポジトリを取得して検証）も備わっています。
バージョン管理規律は2層に分かれており、VERSIONS.md を起点に利用者側の更新チェックを駆動します。リポジトリのリリースバージョンは plugin.json/marketplace.json/VERSIONS.md に反映され、各スキルには個別の metadata.version が付与されます。
AGENTS.md
**Per-skill version** — `metadata.version` in each SKILL.md, mirrored in the `VERSIONS.md` table. Bump on ANY shipped change to that skill: the update check compares `VERSIONS.md` against users' local skill metadata, so an unbumped change is invisible to installed users.
更新チェック手順は AGENTS.md に記載: 'Fetch `VERSIONS.md` from GitHub: https://raw.githubusercontent.com/coreyhaines31/marketingskills/main/VERSIONS.md'。2個以上のスキルに更新がある場合、またはメジャーバージョンの更新時にのみ非ブロッキングで通知する規定です。
スポンサーシップとツール推奨は明確に分離され、ガバナンスドキュメントとして規定されています。パートナーは『開示された存在』であり、推奨順位への加重は行われません。
tools/PARTNERS.md
**Sponsorship funds the work, never the recommendations.** Money buys a *disclosed presence*, never a bias.
README の Partners セクションおよび REGISTRY の Verified Partners 表は、いずれも scripts/sync-partners.mjs を介して partners.json から生成され（<!-- PARTNERS:START/END --> タグ付き）、CI 用の --check モードも備わっています。
2コア機能
01CRO およびランディングページのコンバージョン診断（ページタイプ別に分類、バリュープロポジション／見出し／CTA 階層／信頼シグナル／反論処理などの観点を網羅し、Quick Wins / High-Impact / Test Ideas の3部構成で出力）
02共有プロダクトマーケティングコンテキストドキュメントの作成と保守（バージョン管理および changelog を含み、スキルごとに基礎的な質問を繰り返す手間を排除）
03コピーライティングおよびコンテンツ制作: copywriting / copy-editing / cold-email（B2B コールドメール + フォローアップシーケンス + 件名および業界ベンチマークデータ参照）
04SEO 関連: seo-audit、ai-seo、programmatic-seo、schema、site-architecture（国際 SEO および AI ライティング検知対策のリファレンスを含む）
05有料広告および実験: ads / ad-creative / ab-testing（サンプルサイズ算出ガイドおよびテストテンプレートを含む）
06グロースおよびリテンション: referrals / free-tools / churn-prevention / paywalls / popups / onboarding / signup
07GTM およびレベニューオペレーション: pricing / launch / revops / sales-enablement（反論対応集、デックフレームワーク、デモ用スクリプトを含む）/ prospecting
0864個のマーケティングプラットフォーム向け CLI: GA4 / Mixpanel / Segment / Amplitude / Adobe Analytics / Plausible から、Meta Ads / Google Ads / LinkedIn Ads / TikTok Ads、Klaviyo / Customer.io / Resend / Mailchimp、Ahrefs / Semrush / DataForSEO / G2 など
09戦略およびコミュニケーション: AARRR フレームワークに基づくマーケティング計画、PR・ペイドメディア、オファー設計、イベントマーケティング／ウェビナー、コマーケティング、競合プロファイリング
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | node（64 个零依赖 CLI 的运行时，要求 Node 18+） |
| api | GA4（Data API + Admin API + Measurement Protocol；凭证 GA4_ACCESS_TOKEN） |
| api | Resend（邮件发送；凭证 RESEND_API_KEY） |
| api | Dub（短链/归因；凭证 DUB_API_KEY） |
| api | 其余厂商 API（每个 CLI 一个固定 base URL，共 64 个；鉴权与操作见 tools/integrations/*.md） |
| network | 更新检查（skill 指示 agent 抓取 raw.githubusercontent 上的 VERSIONS.md 比对版本） |
| network | 本地官方校验脚本会克隆并安装官方 skills-ref 库（仅维护者手动运行） |
| network | Composio（为无原生 MCP 的工具提供 MCP 访问的集成层，纯文档指引） |
| package | CI 侧第三方 Action：Flash-Brew-Digital/validate-skill@v1、actions/checkout@v6、stefanzweifel/git-auto-commit-action@v7 |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: tools/clis/*.js（64ファイル）: エージェントまたはユーザーが必要に応じて `node tools/clis/<name>.js <cmd> ...` の形式で呼び出し
- 网络端点: 外部ネットワークアクセスの宣言: tools/clis 配下の64個の CLI が各ベンダーの API（GA4、Resend、Dub、Meta/Google/LinkedIn など）に対して HTTPS リクエストを送信
- 本地工作目录: ファイル読み書きおよび成果物出力: コアスキルがユーザーのプロジェクトファイル（主に product-marketing の成果物であるバージョン情報付きの .agents/product-marketing.md）への書き込みを指示
監査ノート： 判定根拠（6段階基準：認証情報や環境変数の読み取りを伴うためオレンジ判定）：① tools/clis 配下の64本のスクリプトがベンダー API 認証情報の環境変数を100%読み取り、Authorization ヘッダー等で外部送信するため（GA4_ACCESS_TOKEN、RESEND_API_KEY、META_ACCESS_TOKEN、GOOGLE_ADS_TOKEN など）、認証情報の接触およびデータ外部送信が明確に存在します。② スキルがエージェントに対し、更新チェック目的で raw.githubusercontent から VERSIONS.md を取得するよう指示します。③ 配布フローにサードパーティ製 GitHub Actions（Flash-Brew-Digital/validate-skill@v1、stefanzweifel/git-auto-commit-action@v7）が含まれ、ローカルの公式検証スクリプトも外部リポジトリの git clone および pip install を実行します。リスク緩和要因（判定ランクの変更は不可ですが明記必須）：中核となる50個のスキル自体はスクリプト・認証情報の読み取りを一切行いません。CLI の認証情報はすべてユーザー自身の環境変数に依存し、各ベンダーの公式エンドポイントのみに向けられ、--dry-run シミュレーションに対応しており、ローカルディスクへ保存されることもありません。リポジトリは keychain/.env/クッキー等の機密情報にはアクセスしません。スポンサーの推奨管理と情報開示も厳格に統制されています（PARTNERS.md + partners.json + 自動生成スクリプト + CI チェック）。留意点：① エージェントにこれらの CLI を利用させることは、セッションのプロセス環境に対応ベンダーの API キーを渡すことを意味するため、スコープの最小化とキーローテーションを徹底してください。② 特に実際にメール送信や広告作成を行う CLI（resend、meta-ads、google-ads など）では、必ず事前に --dry-run でリクエスト内容を確認してから本番実行してください。③ Claude Code において AGENTS.md に記載された `!command` 注入構文を採用する場合、それは自身のプロジェクト環境内でのコマンド実行となるため、共有用の SKILL.md に直接書き込まないよう注意してください。
5二重目の独立検証
- [ok] skill.path 定位（任务表标『待定位』）；合集条目指向哪个具体 skill — 本条目展示名『Marketing Skills』对应的是 50 个 skill 的合集，仓库根无集合级 SKILL.md。skill.path 现指向 skills/product-marketing —— README 明写它是地基（'The `product-marketing` skill is the foundation — every other skill checks it first'），它产出全部其它 skill 共用的 .agents/product-marketing.md，因此最能代表这个集合的整体形态。其余 49 个 skill 并列于 skills/<name>/（cro、copywriting、seo-audit、ads、analytics、referrals、revops 等）；本 JSON 的 capabilities/traits 按合集口径书写，evidence 分别指向 skills/ 下与 tools/ 下的具体文件。
- [discrepancy] official_desc 取哪一份（合集无集合级 frontmatter description） — 合集在仓库根没有集合级 SKILL.md/frontmatter description（50 个 skill 各有自己的 description 与 metadata.version）。本条目 official_desc 采用代表 skill skills/product-marketing 的 frontmatter description 逐字原文（与 skill.path 指向的具体 skill 一致，满足『official_desc = SKILL.md frontmatter 原文』的取证规则）；集合级口径（plugin.json 的 'Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, ad creative, and growth' 与 marketplace.json 的 50-skill 长描述）已逐字记入 internal_assets 的清单条目说明，不丢失信息。
- [ok] 『核心 skill 无脚本』结论的反例搜索 — find skills -name '*.py' -o -name '*.sh' -o -name '*.js' 零命中；skills/ 下可执行资产为 0，全部内容为 .md 与 evals.json。所有可执行代码集中在 tools/clis（64）、scripts/（sync-partners.mjs）与两个根级 validate-skills*.sh。
- [ok] 『每个 CLI 都读凭证 + 都有 dry-run』是否全量成立 — grep -l 'process.env' tools/clis/*.js = 64；grep -l 'await fetch' = 64；grep -l 'dry-run' = 64。抽样读 ga4.js（三端点 + dry-run 打码 Authorization）、resend.js（api.resend.com）、dub.js（api.dub.co）确认模式一致，非个别实现。
- [ok] 赞助是否会污染推荐（治理是否只是口号） — PARTNERS.md 首条原则逐字 'Sponsorship funds the work, never the recommendations.'；README 与 REGISTRY 的伙伴区块由 partners.json 经 sync-partners.mjs 生成且带 ◆ 披露标记；REGISTRY 明写伙伴『listed alongside the neutral options for the same job, never instead of them』。属可核查的机制而非纯声明（生成脚本 + 标记区块 + --check）。
- [ok] 更新检查的真实动作 — AGENTS.md 'Checking for Updates' 小节逐字给出 raw.githubusercontent 上的 VERSIONS.md 抓取，并要求『Once per session, on first skill use』且仅在 ≥2 skill 有更新或主版本跳变时以非阻塞方式提示；属指示 agent 去抓取，而非仓库自带定时任务。
- [ok] CI 与本地校验的真实命令 — validate-skill.yml 用 matrix + Flash-Brew-Digital/validate-skill@v1 按改动的 SKILL.md 逐个校验；sync-skills.yml 跑 node .github/scripts/sync-skills.js 并自动提交三处清单；validate-skills.sh 为自研 shell 检查（exit 1 on issues）；validate-skills-official.sh 会 git clone github.com/agentskills/agentskills 到 /tmp 并 uv sync / pip install -e，属维护者手动运行的网络+远程包路径。
- [ok] stars / last_push 两源比对 — gh api 实时 stars=50403、pushed_at=2026-09-05T04:48:10Z；queue-100.json 快照为 50403 / 2026-09-05，一致。
6結論
最適な用途： 適している対象: エージェントにデータ（GA4/広告/SEO）を直接照会させ、コピーライティング、LP、コールドメール、CRO 診断の実作業まで落とし込みたいテクニカルマーケターや個人創業者。また、専門知識を「相互参照可能な50のスキル + 実行可能 CLI + テスト評価」へと落とし込むエンジニアリング構造を参考にしたいスキル開発者。Claude Code、Codex、Cursor、Windsurf など、AI Agent Skills をサポートする各種ホスト環境で動作します。
不向きな用途： 適していない対象: ① 単なる文章のリライトのみを求める軽量ユーザー（全パッケージ導入はオーバーヘッド大）。② ベンダーの API キーを対話セッション環境に渡したくないチーム。③ dry-run での確認を挟まずに、大規模な広告出稿や一斉メール送信を完全自動化したいユースケース（本番アカウントに直接副作用が及びます）。④ 単一の絶対的メソッドを求めるユーザー（CRO/SEO/広告/リテンションなど50のスキルを跨ぐため、手法間でトレードオフが存在し、自己判断が必要です）。⑤ マーケティングの全自動運用を期待するユーザー（手法とツールは提供されますが、最終的な戦略判断の代行は行いません）。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload marketing-skills.tar.gz
sha256:
Option B · Copy Guide for Agent27377979bea86ebe…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 5b2c000776.