np-report

Query the D1 production database to generate usage analytics reports.

11|1|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/kayac/nepp-chan --skill np-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: np-report
Source: https://github.com/kayac/nepp-chan/tree/main/.claude/skills/np-report
Command: npx skills add https://github.com/kayac/nepp-chan --skill np-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

本番環境の利用統計を自動で集計・レポート化することで、運用状況の把握と意思決定を迅速化します。

Core Features & Use Cases

  • 全期間/期間指定/週別 の利用統計を集計してレポートを生成
  • サマリー・週別推移・エンゲージメント分布・トピック分析・印象的な話題 などの複数セクションから構成
  • クエリリファレンス(references/queries.md)を参照して適切な SQL を実行し、期間指定で分析を柔軟に対応

Quick Start

クエリリファレンスを参照し、 production データベースから期間指定のクエリを実行して最終レポートを生成します。

Frequently Asked Questions about np-report

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

FAQPage Schema
How do I generate production usage reports from a D1 database?

Production usage reports from a D1 database are generated by executing SQL queries to aggregate conversation counts, user counts, and weekly trends. The Skill references a queries.md file to extract and compose analytics data into a structured report for ongoing monitoring.

What metrics are included in chatbot usage analytics?

Chatbot usage analytics include conversation counts, active user counts, weekly trend transitions, engagement distributions, topic analysis, and notable topics. These metrics are aggregated over all-time or specified periods to monitor chat volume and active user engagement.

Can I filter production database analytics by a specific time period?

Yes, you can filter production database analytics by a specific time period. The Skill executes period-specified SQL queries from the query reference to generate customized reports for weekly trends and topic distributions within your desired timeframe.

What's the best way to monitor active users and chat volume trends?

The best way to monitor active users and chat volume trends is using SQL-based aggregation on a production database. This approach extracts weekly trend data and engagement distributions, composing them into a comprehensive report for ongoing operational monitoring.

Do I need SQL knowledge to run topic analysis on production data?

SQL knowledge is helpful but not strictly required, as the Skill references predefined SQL queries in a queries.md file. It automatically executes the necessary data extraction and aggregation logic to produce topic analysis and notable topics sections.

What limitations exist when using SQL queries for usage reporting?

Usage reporting via SQL queries is limited to the data structures and tables available in the D1 production database. Analysis scope depends on the predefined queries in the references, meaning custom metrics outside this reference may require manual query modification.