directory changes and restructuring

🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-22 02:01:41 +09:00
parent eea49f9f8c
commit 236be6c580
598 changed files with 0 additions and 0 deletions
--- a/ga-agent-skills/02-ga-agent-skill/README.md
+++ b/ga-agent-skills/02-ga-agent-skill/README.md
@@ -0,0 +1,117 @@
+# Component 2: GA Agent Skill
+
+**Type:** Claude Skill
+**Priority:** P0
+**Status:** Not Started
+**Final Location:** `ourdigital-custom-skills/15-ourdigital-ga-agent/`
+
+## Goal
+
+Interactive GA4 analysis and reporting skill for Claude Code.
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| Traffic Analysis | Users, sessions, pageviews with trends |
+| Period Comparison | WoW, MoM, YoY comparisons |
+| Top Content | Pages, sources, campaigns |
+| Report Generation | HTML reports |
+| BigQuery Queries | Complex analysis on exported data |
+
+## Triggers
+
+**English:**
+- "Analyze GA4 traffic"
+- "Compare last week vs this week"
+- "Generate traffic report"
+- "Top landing pages"
+- "Query BigQuery for GA data"
+
+**Korean:**
+- "GA4 트래픽 분석"
+- "지난주 대비 비교"
+- "트래픽 리포트 생성"
+- "인기 랜딩 페이지"
+- "BigQuery GA 데이터 조회"
+
+## Structure
+
+```
+15-ourdigital-ga-agent/
+├── SKILL.md                    # Skill definition
+├── scripts/
+│   ├── analyze_traffic.py      # Traffic analysis
+│   ├── compare_periods.py      # Period comparisons
+│   ├── top_content.py          # Top pages/sources
+│   └── generate_report.py      # HTML report generation
+├── templates/
+│   └── report.html             # Report template
+├── references/
+│   └── ga4-api-reference.md    # Quick API reference
+└── examples/
+    └── sample-queries.md       # Example usage
+```
+
+## Dependencies
+
+Requires Component 1 (MCP Setup) to be complete.
+
+## Scripts
+
+### analyze_traffic.py
+
+Fetches traffic metrics for a date range:
+- Active users
+- Sessions
+- Pageviews
+- Bounce rate
+- Session duration
+
+### compare_periods.py
+
+Compares metrics between two periods:
+- Current vs previous period
+- Percentage changes
+- Trend indicators
+
+### top_content.py
+
+Lists top performing content:
+- Landing pages
+- Traffic sources
+- Campaigns
+- Countries/cities
+
+### generate_report.py
+
+Generates HTML report with:
+- Summary metrics
+- Charts (via Plotly)
+- Top content tables
+- Period comparison
+
+## Development
+
+```bash
+# Work in this directory
+cd 02-ga-agent-skill
+
+# Create skill structure
+mkdir -p skill/{scripts,templates,references,examples}
+
+# When complete, move to final location
+mv skill ../ourdigital-custom-skills/15-ourdigital-ga-agent
+```
+
+## Checklist
+
+- [ ] SKILL.md created
+- [ ] analyze_traffic.py
+- [ ] compare_periods.py
+- [ ] top_content.py
+- [ ] generate_report.py
+- [ ] report.html template
+- [ ] Examples documented
+- [ ] Tested with Claude Code
+- [ ] Moved to ourdigital-custom-skills/