refactor(skills): Restructure skills to dual-platform architecture
Major refactoring of ourdigital-custom-skills with new numbering system: ## Structure Changes - Each skill now has code/ (Claude Code) and desktop/ (Claude Desktop) versions - New progressive numbering: 01-09 General, 10-19 SEO, 20-29 GTM, 30-39 OurDigital, 40-49 Jamie ## Skill Reorganization - 01-notion-organizer (from 02) - 10-18: SEO tools split into focused skills (technical, on-page, local, schema, vitals, gsc, gateway) - 20-21: GTM audit and manager - 30-32: OurDigital designer, research, presentation - 40-41: Jamie brand editor and audit ## New Files - .claude/commands/: Slash command definitions for all skills - CLAUDE.md: Updated with new skill structure documentation - REFACTORING_PLAN.md: Migration documentation - COMPATIBILITY_REPORT.md, SKILLS_COMPARISON.md: Analysis docs ## Removed - Old skill directories (02-05, 10-14, 20-21 old numbering) - Consolidated into new structure with _archive/ for reference 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
90
ourdigital-custom-skills/20-gtm-audit/README.md
Normal file
90
ourdigital-custom-skills/20-gtm-audit/README.md
Normal file
@@ -0,0 +1,90 @@
|
||||
# OurDigital GTM Audit
|
||||
|
||||
Lightweight Google Tag Manager audit toolkit powered by Playwright.
|
||||
|
||||
> **Note**: For comprehensive GTM management including dataLayer tag generation, see [14-ourdigital-gtm-manager](../14-ourdigital-gtm-manager/).
|
||||
|
||||
## Features
|
||||
|
||||
- **Container Detection**: Verify GTM installation, position, and duplicates
|
||||
- **DataLayer Validation**: Event structure, types, sequence checking
|
||||
- **Form Tracking**: Form discovery, field analysis, event verification
|
||||
- **E-commerce Checkout**: Full funnel flow simulation and validation
|
||||
- **Multi-Platform**: GA4, Meta Pixel, LinkedIn, Google Ads, Kakao, Naver
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
# Clone or download
|
||||
cd gtm-audit-claude-code
|
||||
|
||||
# Install dependencies
|
||||
pip install -r requirements.txt
|
||||
|
||||
# Install Playwright browsers
|
||||
playwright install chromium
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
# Full audit
|
||||
python gtm_audit.py --url "https://yoursite.com" --journey full
|
||||
|
||||
# Specific container validation
|
||||
python gtm_audit.py --url "https://yoursite.com" --container "GTM-XXXXXX"
|
||||
|
||||
# Form tracking only
|
||||
python gtm_audit.py --url "https://yoursite.com/contact" --journey form
|
||||
|
||||
# E-commerce checkout
|
||||
python gtm_audit.py --url "https://yoursite.com/cart" --journey checkout
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
| Option | Description | Default |
|
||||
|--------|-------------|---------|
|
||||
| `--url` | Target URL (required) | - |
|
||||
| `--container` | Expected GTM container ID | None |
|
||||
| `--journey` | Audit type: pageview, scroll, form, checkout, datalayer, full | full |
|
||||
| `--output` | Output file path | gtm_audit_report.json |
|
||||
| `--timeout` | Page load timeout (ms) | 30000 |
|
||||
| `--headless` | Run browser headless | True |
|
||||
|
||||
## Output
|
||||
|
||||
Generates JSON report with:
|
||||
- Container status
|
||||
- DataLayer events and validation issues
|
||||
- Form analysis and tracking readiness
|
||||
- Checkout flow analysis
|
||||
- Network requests by destination
|
||||
- Recommendations and checklist
|
||||
|
||||
## Using with Claude Code
|
||||
|
||||
This project includes a `CLAUDE.md` file optimized for use with Claude Code.
|
||||
|
||||
```bash
|
||||
# In your terminal
|
||||
claude
|
||||
|
||||
# Then ask Claude to run audits
|
||||
> Run a GTM audit on https://example.com
|
||||
> Check the form tracking on https://example.com/contact
|
||||
> Analyze the checkout flow issues in the latest report
|
||||
```
|
||||
|
||||
## Documentation
|
||||
|
||||
See `docs/` folder for:
|
||||
- GA4 event specifications
|
||||
- E-commerce dataLayer schemas
|
||||
- Form tracking patterns
|
||||
- Checkout flow sequences
|
||||
- Common issues and fixes
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
Reference in New Issue
Block a user