johnalbertini14-glitch Arccos Golf Performance Analyzer
Comprehensive analysis tool for Arccos Golf performance data including club distances, strokes gained metrics, scoring patterns, putting analysis, and performance trends.
Description
This skill provides detailed analysis of golf performance data from Arccos Golf sensors. It processes pre-collected Arccos data and generates insights into:
- Strokes Gained Analysis: Performance vs. PGA Tour averages across driving, approach, short game, and putting
- Club Distance Tracking: Average distances, shot counts, and longest shots for each club
- Scoring Patterns: Performance on different par values and score distribution analysis
- Putting Performance: Putts per round, GIR putting, and distance-based performance
- Approach Shot Analysis: Greens in regulation, miss patterns, and performance by distance/terrain
- Round-by-Round Tracking: Recent performance trends and course-specific analysis
Key Features:
- Comprehensive strokes gained breakdown with improvement recommendations
- Club distance analysis with filtering capabilities
- Scoring tendency analysis (birdie %, par %, bogey+ %)
- Putting performance metrics including three-putt frequency
- Approach shot miss pattern analysis
- Recent round performance tracking
- Multiple output formats (human-readable text and machine-readable JSON)
System Access
File System:
- READ: Single Arccos data JSON file (path provided as command-line argument)
Network Access: None
Subprocess/Shell: None
What It Does NOT Do
This skill is designed for data analysis only and explicitly does NOT:
- No network access: Does not connect to Arccos Golf services or any external APIs
- No web scraping: Does not perform browser automation or web requests to Arccos dashboard
- No subprocess execution: Does not run external commands or shell scripts
- No file writes: Does not create, modify, or delete any files (read-only operation)
- No credential handling: Does not store, read, or manage login credentials
- No data collection: Does not gather data from Arccos sensors or dashboard
Data Collection: Arccos does not offer a public API. Data collection requires separate browser automation tooling (not included in this skill). See the README for guidance on how to populate the data file.
Resources
Scripts
scripts/arccos_golf.py- Main analysis script (Python 3.8+ required)
Usage
Basic Analysis (Full Report)
python3 scripts/arccos_golf.py /path/to/arccos-data.json
Summary Statistics Only
python3 scripts/arccos_golf.py /path/to/arccos-data.json --summary
Strokes Gained Analysis
python3 scripts/arccos_golf.py /path/to/arccos-data.json --strokes-gained
Club Distance Analysis
# All clubs
python3 scripts/arccos_golf.py /path/to/arccos-data.json --clubs all
# Filter by club type
python3 scripts/arccos_golf.py /path/to/arccos-data.json --clubs iron
python3 scripts/arccos_golf.py /path/to/arccos-data.json --clubs wedge
python3 scripts/arccos_golf.py /path/to/arccos-data.json --clubs wood
JSON Output
python3 scripts/arccos_golf.py /path/to/arccos-data.json --format json
Recent Rounds Analysis
# Last 10 rounds
python3 scripts/arccos_golf.py /path/to/arccos-data.json --recent-rounds 10
Expected Data Format
The script expects a JSON file with the following structure:
{
"golfer": "Player Name",
"last_fetched": "2026-02-22",
"total_shots": 7057,
"total_rounds": 75,
"longest_shot": 308,
"strokes_gained": {
"overall": -12.0,
"driving": -3.3,
"approach": -5.0,
"short_game": -2.7,
"putting": -1.1
},
"scoring": {
"par3_avg": 3.8,
"par4_avg": 5.4,
"par5_avg": 6.3,
"birdies_pct": 2.0,
"pars_pct": 17.8,
"bogeys_pct": 41.8,
"double_plus_pct": 38.4
},
"clubs": [
{
"club": "Driver",
"avg_distance": 234,
"smart_distance": null,
"longest": 281,
"total_shots": 533
}
],
"recent_rounds": [
{
"date": "2026-02-01",
"course": "Las Vegas GC",
"score": 82,
"over_par": 10
}
]
}
Example Output (Text Format)
🏌️ Arccos Golf Performance Report
========================================
Golfer: Paul Frederiksen
Last Updated: 2026-02-22
Total Shots Tracked: 7,057
Total Rounds: 75
Longest Drive: 308 yards
📊 STROKES GAINED ANALYSIS
------------------------------
Overall: -12.0
Driving: -3.3
Approach: -5.0
Short Game: -2.7
Putting: -1.1
⚠️ Areas for Improvement:
• Approach: -5.0
• Driving: -3.3
• Short Game: -2.7
• Putting: -1.1
🎯 Priority Areas:
1. Approach
2. Driving
3. Short Game
🏌️ CLUB DISTANCES
--------------------
Driver: 234 yds avg (533 shots, longest: 281)
3 Wood: 204 yds avg (57 shots, longest: 320)
5 Wood: 182 yds avg (322 shots, longest: 206)
4 Iron: 149 yds avg (32 shots, longest: 171)
⛳ SCORING ANALYSIS
--------------------
Par 3 Average: 3.8
Par 4 Average: 5.4
Par 5 Average: 6.3
Score Distribution:
Birdies+: 2.0%
Pars: 17.8%
Bogeys: 41.8%
Double+: 38.4%
⛳ PUTTING ANALYSIS
--------------------
Putts per Round: 35.9
GIR Putts: 2.2
One-Putts: 15.8%
Three-Putts+: 15.1%
📈 RECENT ROUNDS
--------------------
2026-02-01: 82 (+10) at Las Vegas GC
2026-01-25: 93 (+21) at Stallion Mountain CC
2026-01-17: 95 (+23) at Coyote Springs GC
2026-01-10: 98 (+26) at Boulder Creek GC
Analysis Categories
Strokes Gained
- Overall: Total strokes gained/lost vs. PGA Tour average
- Driving: Performance from tee to landing position
- Approach: Performance from fairway/rough to green
- Short Game: Chipping and pitching performance
- Putting: Performance on the green
Club Analysis
- Average carry distances for each club
- Shot count and consistency metrics
- Longest recorded shots
- Smart distance recommendations (when available)
Scoring Patterns
- Performance on different par values (3, 4, 5)
- Score distribution (birdies, pars, bogeys, doubles+)
- Scoring tendencies and consistency metrics
Putting Metrics
- Putts per round and per hole
- Performance on greens in regulation
- One-putt and three-putt+ percentages
- Distance-based putting performance
Dependencies
- Python 3.8+
- Standard library only (json, sys, argparse, statistics, datetime, pathlib, typing)
Installation
This skill can be installed via ClawHub:
clawhub install arccos-golf
Or manually by cloning the repository and placing it in your OpenClaw skills directory.
Error Handling
The script provides specific error handling for:
FileNotFoundError: When the specified JSON file doesn't existjson.JSONDecodeError: When the JSON file is malformedKeyboardInterrupt: Graceful handling of user interruption- Graceful handling of missing or malformed data fields with appropriate defaults
Output Formats
- Text (default): Human-readable formatted report with emojis and clear sections
- JSON: Machine-readable structured data for further processing
Privacy & Security
- All processing is done locally on the provided data file
- No external network connections are made
- No credentials or sensitive data are stored or transmitted
- Data is processed in memory only with no persistent storage
- Uses only Python standard library modules for security compliance
- No subprocess calls or shell execution
Performance Insights
The analyzer provides actionable insights including:
- Improvement Priority: Ranks weakest areas by strokes gained impact
- Club Recommendations: Distance gaps and consistency analysis
- Scoring Patterns: Identifies holes types where performance suffers
- Putting Analysis: Short game improvement opportunities
- Round Trends: Performance consistency and course-specific insights
Golf Terminology
- Strokes Gained: Measures performance vs. statistical baseline (PGA Tour average)
- GIR: Greens in Regulation (reaching green in regulation strokes)
- Smart Distance: Arccos recommendation for club selection
- Carry Distance: Distance ball travels in air before landing
- Up and Down: Getting ball in hole within 2 strokes from off-green position