scouter-notifications

Automate Scouter notification queries and management via scouterctl.py with JSON output.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/BriarDevv/Scouter --skill scouter-notifications
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scouter-notifications
Source: https://github.com/BriarDevv/Scouter/tree/main/skills/scouter-notifications
Command: npx skills add https://github.com/BriarDevv/Scouter --skill scouter-notifications

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Scouter notifications can be time-consuming to track, categorize, and resolve manually. This skill automates querying, aggregation, and actioning of alerts from Scouter's notification system, reducing latency and manual effort.

Core Features & Use Cases

  • Notification review: list, filter, and view notifications by category or severity.
  • Count and summarize: provide unread counts and totals across categories.
  • Resolve and mark read: perform resolution actions and mark items as read via CLI.

Quick Start

Activate the virtual environment and run the scouterctl script with your chosen command.

Frequently Asked Questions about scouter-notifications

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

FAQPage Schema
How do I automate querying and resolving Scouter notifications from the CLI?

Automating Scouter notifications involves running python scripts/scouterctl.py --data-only --compact <cmd> to query, filter by category, and resolve alerts. The script returns JSON output for seamless integration into automated workflows.

Can I filter Scouter alerts by business, system, or security categories?

Yes, filtering Scouter alerts by category is supported. The script processes business, system, and security notification contexts, returning compact JSON output that allows targeted review and resolution of specific alert types.

What's the best way to get unread notification counts from Scouter via command line?

Getting unread counts from Scouter requires executing the scouterctl script with count and summarize commands. It aggregates unread totals across business, system, and security categories, outputting the results in structured JSON format.

Does the Scouter notification CLI require any external dependencies?

No external dependencies are required. The skill operates independently using included scripts, requiring only a Python environment to execute the scouterctl.py script for managing and resolving alert notifications.

How do I mark Scouter notifications as read or resolve alerts in bulk?

Marking notifications as read and resolving alerts is handled by passing resolution action commands to the scouterctl script. It processes these actions via CLI and returns JSON confirming the updated status of the notifications.

What JSON output format does the Scouter notification CLI return?

The CLI returns compact JSON output generated by running scouterctl.py with the --data-only and --compact flags. This format structures notification data, unread counts, and alert categories for automated parsing and downstream processing.