ga4
Query Google Analytics 4 (GA4) data via the Analytics Data API. Use when you need to pull website analytics like top pages, traffic sources, user counts, sessions, conversions, or any GA4 metrics/dimensions. Supports custom date ranges and filtering.
92
Does it follow best practices?
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that excels across all dimensions. It provides specific capabilities, includes natural trigger terms users would actually say, explicitly states both what the skill does and when to use it, and has a clear distinctive niche in the GA4/analytics domain.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'pull website analytics like top pages, traffic sources, user counts, sessions, conversions' and mentions 'custom date ranges and filtering' as capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Query GA4 data via Analytics Data API, supports custom date ranges and filtering') and when ('Use when you need to pull website analytics like top pages, traffic sources...') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'Google Analytics', 'GA4', 'website analytics', 'top pages', 'traffic sources', 'user counts', 'sessions', 'conversions', 'metrics', 'dimensions' - all terms users naturally use when requesting analytics data. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche - specifically targets Google Analytics 4 and the Analytics Data API, with domain-specific triggers like 'GA4', 'traffic sources', 'conversions' that are unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, concise skill with excellent actionability through copy-paste ready commands. The main weakness is the lack of validation steps in the setup process and no error handling guidance for common failure modes like invalid credentials or missing permissions.
Suggestions
Add a validation step after setup, e.g., 'Test your setup: python3 scripts/ga4_query.py --metric sessions --dimension date --limit 1' with expected output
Include brief troubleshooting for common errors (invalid credentials, API not enabled, wrong property ID)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanations of what GA4 is or how APIs work. Every section provides direct, actionable information without padding. | 3 / 3 |
Actionability | Fully executable bash commands with real flags and parameters. Copy-paste ready examples covering common use cases with specific metric/dimension names. | 3 / 3 |
Workflow Clarity | Setup steps are clear and sequenced, but there's no validation or error handling guidance. No mention of what to do if queries fail, credentials are invalid, or how to verify the setup worked. | 2 / 3 |
Progressive Disclosure | Well-organized with clear sections progressing from setup to common queries to reference lists. Appropriate length for a single file without needing external references. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 13 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
license_field | 'license' field is missing | Warning |
Total | 13 / 16 Passed | |
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.