nl-to-query

Convert natural language hockey questions into structured data queries.

2|1|Updated May 1, 2026
One-click install
npx skills add https://github.com/PuckAPI/claude-sports-analytics --skill nl-to-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nl-to-query
Source: https://github.com/PuckAPI/claude-sports-analytics/tree/main/skills/nl-to-query
Command: npx skills add https://github.com/PuckAPI/claude-sports-analytics --skill nl-to-query

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill transforms plain English hockey research questions into structured, executable data queries, simplifying complex data retrieval tasks.

Core Features & Use Cases

  • Natural Language Translation: Converts user questions about games, players, teams, or stats into specific data filters and commands.
  • Intelligent Context Handling: Recognizes scope and intent, adjusting queries for time frames, conditions, and relevant metrics.
  • Use Case: Asking "How often do goalies with 2 days rest outperform their season SV%?" automatically generates a query to filter goalies by rest days and compares their performance metrics.

Quick Start

Ask Claude in plain English: "Find the last 20 games where the home team was outshot but won."

Frequently Asked Questions about nl-to-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert natural language hockey questions into structured data queries?

To convert natural language hockey questions into structured data queries, this Skill identifies conditions and maps them to data fields, translating plain English into specific filters for game, team, or player metrics.

Can I filter NHL stats by rest days and save percentage using plain English?

Yes, you can filter NHL stats by rest days and save percentage using plain English, as the Skill recognizes intent and time frames to automatically generate precise performance metric comparisons.

How does natural language query generation work for hockey stats?

Natural language query generation for hockey stats works by parsing user inquiries, identifying relevant conditions, and mapping them to structured data fields to retrieve specific game or player information.

Do I need to know a query language to retrieve goalie performance metrics?

No, you do not need to know a query language to retrieve goalie performance metrics; the Skill translates plain English questions into executable data queries automatically.

What are the limitations of using natural language for hockey data translation?

The primary limitation of natural language hockey data translation is that query accuracy depends on how clearly the plain English question defines specific conditions, time frames, and relevant metrics.

What is the best way to find historical games where the home team was outshot but won?

The best way to find historical games where the home team was outshot but won is asking Claude in plain English, which generates a structured query to filter and retrieve those specific game results.