ocho-lo/adpilot-skill-pack
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
AdPilot Skill Pack is a lightweight, local-first advertising analysis skill pack for agent coding environments such as Claude Code, Codex, Cursor, and similar tools.
概要
AdPilot Skill Pack is a lightweight, local-first advertising analysis skill pack for agent coding environments such as Claude Code, Codex, Cursor, and similar tools. It helps agents analyze exported advertising CSV/JSON files with deterministic Python scripts instead of asking the model to invent metrics. The first version focuses on Chinese advertising workflows while keeping common English field aliases compatible. This repository is only the open-source skill pack. It does not include the original AdPilot web platform, OAuth integrations, account systems, backend services, or real advertising platform write operations. Shared calculation code lives in skills/_shared/adpilot_common.py. Example data lives in skills/fixtures/. - Python 3.10 or newer recommended. - No Python package installation is required; scripts use the standard library only. - No backend, database, OAuth, API key, or advertising account connection is required.
README
以下は原文 README の抜粋です。原文を見る。
AdPilot Skill Pack
AdPilot Skill Pack is a lightweight, local-first advertising analysis skill pack for agent coding environments such as Claude Code, Codex, Cursor, and similar tools.
It helps agents analyze exported advertising CSV/JSON files with deterministic Python scripts instead of asking the model to invent metrics. The first version focuses on Chinese advertising workflows while keeping common English field aliases compatible.
This repository is only the open-source skill pack. It does not include the original AdPilot web platform, OAuth integrations, account systems, backend services, or real advertising platform write operations.
What is included
| Skill | Purpose |
|---|---|
adpilot-normalize-report |
Normalize local CSV/JSON exports into the AdPilot schema. |
adpilot-diagnose |
Calculate CPA, ROI, CTR, CVR, channel metrics, campaign metrics, and findings. |
adpilot-budget-planner |
Generate cautious next-period budget allocation suggestions from historical performance. |
adpilot-anomaly-scan |
Detect unusual CPA, ROI, CVR, and spend movement. |
adpilot-health-score |
Produce an explainable 0-100 advertising health score. |
adpilot-report-export |
Generate a Chinese Markdown recap from deterministic metrics. |
Shared calculation code lives in skills/_shared/adpilot_common.py. Example data lives in skills/fixtures/.
Requirements
- Python 3.10 or newer recommended.
- No Python package installation is required; scripts use the standard library only.
- No backend, database, OAuth, API key, or advertising account connection is required.
Quick start
Clone the repository and run scripts from the repository root:
git clone https://github.com//adpilot-skill-pack.git
cd adpilot-skill-pack
python3 skills/adpilot-normalize-report/scripts/normalize_report.py skills/fixtures/mock_ad_data.json
Run the six core workflows:
python3 skills/adpilot-normalize-report/scripts/normalize_report.py skills/fixtures/mock_ad_data.json
python3 skills/adpilot-diagnose/scripts/diagnose.py skills/fixtures/mock_ad_data.json
python3 skills/adpilot-budget-planner/scripts/budget_plan.py skills/fixtures/mock_ad_data.json --total-budget 100000
python3 skills/adpilot-anomaly-scan/scripts/anomaly_scan.py skills/fixtures/anomaly_report.csv
python3 skills/adpilot-health-score/scripts/health_score.py skills/fixtures/mock_ad_data.json
python3 skills/adpilot-report-export/scripts/export_report.py skills/fixtures/mock_ad_data.json --output /tmp/adpilot-report.md
Every script prints JSON to stdout. adpilot-report-export can also write a Markdown file with --output.
Using with an agent
Point your agent at the relevant SKILL.md file, or copy the full skills/ directory into a location supported by your agent runtime.
Keep the entire skills/ directory together. The individual skill entrypoints depend on the shared helper at skills/_shared/adpilot_common.py.
推奨ツール
別のキーワードを試すか、フィルタを外してください。
インストール
npx skillfish add ocho-lo/adpilot-skill-pack