PredictHQ Agent Skills

A collection of skills for AI coding agents building integrations with PredictHQ.

Skills follow the Agent Skills format and work with Claude Code, Cursor, Gemini CLI, GitHub Copilot, and other compatible agents.

Available Skills

predicthq-best-practices

Integration best practices for PredictHQ APIs. Covers the recommended workflow from location setup through to production features, API selection, Beam analysis, and common mistakes to avoid.

Use when:

• Writing code that integrates with PredictHQ APIs
• Setting up Saved Locations, Beam analyses, or Features API calls
• Building demand forecasting, staffing, pricing, or visibility features using event data
• Reviewing or debugging an existing PredictHQ integration

Covers:

• Integration workflow: Saved Locations → Beam → Features API → Events API
• When to use Features API, Events API, and Forecasts API
• Geographic scope setup with Saved Locations and Predicted Impact Area
• Running and applying Beam to identify which events drive demand at each location
• Common integration mistakes and how to avoid them

Install

npx skills add predicthq/agent-skills

Resources

• PredictHQ Documentation
• API Reference
• MCP Server