nightscout-cgm
Analyze CGM blood glucose data from Nightscout. Use this skill when asked about current glucose levels, blood sugar trends, A1C estimates, time-in-range statistics, glucose variability, or diabetes management insights.
- License 许可
- MIT
- 最近更新
- 2026-05-26
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- nightscout-cgm
- description
- Analyze CGM blood glucose data from Nightscout. Use this skill when asked about current glucose levels, blood sugar trends, A1C estimates, time-in-range statistics, glucose variability, or diabetes management insights.
02 资源文件 28
- 参考文档.github/workflows/test.yml895 B
- 其他.gitignore417 B
- 参考文档docs/IMPROVEMENTS.md3.1 KB
- 参考文档docs/TEST_COVERAGE_ANALYSIS.md5.4 KB
- 资产文件images/heatmap.png13.3 KB
- 资产文件images/heatmap2.png240.1 KB
- 资产文件images/newcharts.png189.9 KB
- 许可证LICENSE1.0 KB
- 其他pytest.ini365 B
- 参考文档README.md21.6 KB
- 参考文档requirements.txt85 B
- 脚本scripts/cgm.py228.4 KB
- 脚本show-all-charts.ps12.9 KB
- 脚本tests/__init__.py33 B
- 脚本tests/conftest.py9.1 KB
- 参考文档tests/fixtures/nightscout_24h_real.json78.7 KB
- 脚本tests/test_analysis.py20.9 KB
- 脚本tests/test_charts.py15.1 KB
- 脚本tests/test_cli.py13.5 KB
- 脚本tests/test_compare.py11.6 KB
- 脚本tests/test_coverage_gaps.py5.3 KB
- 脚本tests/test_database.py8.6 KB
- 脚本tests/test_edge_cases.py18.2 KB
- 脚本tests/test_pump.py24.5 KB
- 脚本tests/test_pure_functions.py14.6 KB
- 脚本tests/test_real_data.py10.6 KB
- 脚本tests/test_report.py39.0 KB
- 脚本tests/test_trend_alerts.py12.3 KB
03 SKILL.md 正文
Nightscout CGM Analysis Skill
This skill provides tools for fetching and analyzing Continuous Glucose Monitor (CGM) data from Nightscout.
⚠️ Before Making Changes
Always run tests before and after modifying cgm.py:
cd <skill-path>
python -m pytest tests/ -q # Quick check (255+ tests)
python -m pytest tests/ --cov=scripts # With coverage
Available Commands
Run the cgm.py script from this skill's scripts/ directory:
python <skill-path>/scripts/cgm.py <command> [options]
Where <skill-path> is the location where this skill is installed (e.g., ~/.copilot/skills/nightscout-cgm, .github/skills/nightscout-cgm, or .claude/skills/nightscout-cgm).
Commands
| Command | Description |
|---|---|
current |
Get the latest glucose reading |
analyze [--days N] |
Analyze CGM data (default: 90 days) |
report [--days N] [--open] |
Generate interactive HTML report with charts |
compare --period1 P1 --period2 P2 |
Compare two time periods side-by-side |
alerts [--days N] |
Get trend alerts for recurring patterns |
refresh [--days N] |
Fetch latest data from Nightscout |
patterns [--days N] |
Find interesting patterns (best/worst times, problem areas) |
query [options] |
Query with filters (day of week, time range) |
day <date> [options] |
View all readings for a specific date |
worst [options] |
Find your worst days for glucose control |
chart [options] |
Terminal visualizations (heatmap, sparkline, day chart) |
pump |
Get current pump status (IOB, COB, predicted glucose) * |
treatments [--hours N] |
Get recent treatments (boluses, temp basals, carbs) * |
profile |
Get pump profile settings (basal rates, ISF, carb ratios) * |
* Pump commands require Loop, OpenAPS, or similar closed-loop system. The skill auto-detects pump capabilities on first use. CGM-only users won't see errors—commands simply report that pump data isn't available.
Report Command
Generate a comprehensive, self-contained HTML report with interactive charts:
--days N- Number of days to include (default: 90)--output PATH- Custom output path (default: nightscout_report.html)--open- Open report in browser after generating
Auto-Sync: Reports automatically sync from Nightscout if local data is more than 30 minutes old.
Report Features:
- Interactive date controls (7d/14d/30d/90d/6mo/1yr/All + custom date pickers)
- All charts recalculate dynamically in browser
- Time-in-Range pie chart
- Modal Day (24-hour profile with percentile bands)
- Daily trends, Day of week comparison
- Glucose histogram, Heatmap with hover tooltips
- Weekly summary
- Key stats: TIR%, GMI (estimated A1C), CV (variability)
- Insulin Delivery (if using Loop/OpenAPS): TDD breakdown (bolus/basal), stacked bar chart, carb tracking
Day Command
View detailed readings for a specific date:
day <date>- Date can be 'today', 'yesterday', '2026-01-16', or 'Jan 16'--hour-start H- Start hour for time window (0-23)--hour-end H- End hour for time window (0-23)
Worst Command
Find your worst days ranked by peak glucose:
--days N- Number of days to search (default: 21)--hour-start H- Start hour for time window (0-23)--hour-end H- End hour for time window (0-23)--limit N- Number of worst days to show (default: 5)
Query Options
The query command supports flexible filtering:
--days N- Number of days to analyze (default: 90)--day NAME- Filter by day of week (e.g., Tuesday, or 0-6 where 0=Monday)--hour-start H- Start hour for time window (0-23)--hour-end H- End hour for time window (0-23)
Chart Options
The chart command creates terminal visualizations:
--sparkline- Compact trend line using Unicode blocks (▁▂▃▄▅▆▇█)--hours N- Hours of data for sparkline (default: 24)--date DATE- Specific date for sparkline (e.g., today, yesterday, 2026-01-16)--hour-start H- Start hour for sparkline time window (0-23)--hour-end H- End hour for sparkline time window (0-23)--heatmap- Weekly grid showing time-in-range by day and hour--day NAME- Hourly breakdown for a specific day of week--color- Use ANSI colors (for direct terminal, not inside Copilot)
Pump Commands (Optional)
These commands require a closed-loop system (Loop, OpenAPS, AndroidAPS, etc.) uploading to Nightscout. The skill auto-detects pump capabilities—CGM-only users won't be bothered with errors.
pump - Get current pump/loop status:
- IOB (Insulin on Board) and COB (Carbs on Board)
- Predicted glucose trajectory
- Recommended bolus
- Last enacted action (temp basal or bolus)
- Pump status (manufacturer, model, suspended/bolusing)
- Phone battery level
treatments [--hours N] - Get recent treatments:
- Boluses (automatic and manual)
- Temp basals
- Carb entries
- Summary totals (total insulin, total carbs)
profile - Get pump profile settings:
- Basal rates by time of day
- Total daily basal
- ISF (Insulin Sensitivity Factor) by time
- Carb ratios by time
- Target glucose ranges
- Loop settings (max bolus, pre-meal targets, override presets)
Examples
# Get current glucose
python scripts/cgm.py current
# Generate interactive HTML report (opens in browser)
python scripts/cgm.py report --days 90 --open
# Analyze last 30 days
python scripts/cgm.py analyze --days 30
# Find patterns automatically (best/worst times, problem areas)
python scripts/cgm.py patterns
# What happened yesterday during lunch (11am-2pm)?
python scripts/cgm.py day yesterday --hour-start 11 --hour-end 14
# Find my worst lunch days in the last 3 weeks
python scripts/cgm.py worst --days 21 --hour-start 11 --hour-end 14
# What happens on Tuesdays after lunch?
python scripts/cgm.py query --day Tuesday --hour-start 12 --hour-end 15
# How are my overnight numbers on weekends?
python scripts/cgm.py query --day Saturday --hour-start 22 --hour-end 6
python scripts/cgm.py query --day Sunday --hour-start 22 --hour-end 6
# Morning analysis across all days
python scripts/cgm.py query --hour-start 6 --hour-end 10
# Show sparkline of last 24 hours (compact visual trend)
python scripts/cgm.py chart --sparkline --hours 24
# Show sparkline for a specific date and time range (with colors)
python scripts/cgm.py chart --date yesterday --hour-start 11 --hour-end 15 --color
# Show heatmap of time-in-range by day/hour
python scripts/cgm.py chart --heatmap
# Show hourly breakdown for a specific day
python scripts/cgm.py chart --day Saturday
# Generate interactive HTML report (opens in browser)
python scripts/cgm.py report --days 90 --open
# Compare two time periods
python scripts/cgm.py compare --period1 "last 7 days" --period2 "previous 7 days"
python scripts/cgm.py compare --period1 "this week" --period2 "last week"
# Get trend alerts (recurring patterns)
python scripts/cgm.py alerts --days 30
# Refresh data from Nightscout
python scripts/cgm.py refresh
Example Questions You Can Ask
With the pattern analysis capabilities, you can ask natural questions like:
- "What's my current glucose?"
- "Generate a report of my last 90 days"
- "Compare this week to last week"
- "How am I doing vs last month?"
- "What trend alerts do you see?"
- "Analyze my blood sugar for the last 30 days"
- "What patterns do you see in my data?"
- "What's happening on Tuesdays after lunch?"
- "When are my worst times for blood sugar control?"
- "How are my overnight numbers?"
- "When do I tend to go low?"
- "What day of the week is my best for time-in-range?"
- "Show me my morning patterns"
- "Show me a sparkline of my last 24 hours"
- "Show me a heatmap of my glucose"
- "What does Saturday look like?"
- "What was my worst lunch this week?" (you'll be asked what hours you eat lunch)
- "Show me what happened yesterday during dinner"
- "What were my worst days for breakfast the last two weeks?"
Pump-Related Questions (if using Loop/OpenAPS)
- "What's my current IOB?"
- "How much insulin on board do I have?"
- "Show me my pump status"
- "What's my predicted glucose?"
- "What treatments have I had in the last 6 hours?"
- "How much insulin did I take today?"
- "What are my basal rates?"
- "What's my carb ratio?"
- "What are my ISF settings?"
- "Show me my Loop profile"
Output Interpretation
Time in Range (TIR)
- Very Low (<54 mg/dL): Dangerous hypoglycemia
- Low (54-69 mg/dL): Hypoglycemia
- In Range (70-180 mg/dL): Target range
- High (181-250 mg/dL): Hyperglycemia
- Very High (>250 mg/dL): Significant hyperglycemia
Key Metrics
- GMI: Glucose Management Indicator (estimated A1C from CGM data)
- CV: Coefficient of Variation (<36% indicates stable glucose)
- Hourly Averages: Shows patterns throughout the day
Configuration (Required)
Set the NIGHTSCOUT_URL environment variable to your Nightscout API endpoint:
# Linux/macOS
export NIGHTSCOUT_URL="https://your-nightscout-site.com/api/v1/entries.json"
# Windows PowerShell
$env:NIGHTSCOUT_URL = "https://your-nightscout-site.com/api/v1/entries.json"
# Windows (persistent)
[Environment]::SetEnvironmentVariable("NIGHTSCOUT_URL", "https://your-nightscout-site.com/api/v1/entries.json", "User")
The script will not run without this environment variable configured.
04 同仓库更多 Skills
zustand-store-ts
Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.
zustand-store-creator
Zustand Store Creator - Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category.
zero-trust-config-helper
Zero Trust Config Helper - Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category.
zapier-integration-helper
Zapier Integration Helper - Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category.
zai-cli
Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY.
yt-research
Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.