Agent skill

Alert Ledger

by shepherdjerred in shepherdjerred/monorepo

Query the read-only Alerts occurrence ledger with toolkit alerts.

GPL-3.0Auto-check passed

Install Alert Ledger

skills CLI
$ npx skills add shepherdjerred/monorepo --skill alert-ledger -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shepherdjerred/monorepo alert-ledger --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shepherdjerred/monorepo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/toolkit/skills/alert-ledger .claude/skills/alert-ledger && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
alert-ledger
GitHub stars
112
Token cost
~469 tokens
SKILL.md length
158 words
Files
2
Skills in repo
63
Repo updated
First seen
Licence
GPL-3.0

At a glance

Query the read-only Alerts occurrence ledger with toolkit alerts.

  • Active-alert checks
  • SKILL.md covers Query occurrences, Inspect lifecycle evidence and Connection boundary
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Historical opened

What it does

Alert Ledger is an agent skill from shepherdjerred/monorepo. Query the read-only Alerts occurrence ledger with toolkit alerts. Use for active-alert checks, historical opened or resolved range queries, alert search and filtering, or inspection of one occurrence's lifecycle events.

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

The repository describes itself as: Monorepo for all of my projects. The licence is GPL-3.0.

When your agent uses it

  • Active-alert checks
  • Historical opened
  • Resolved range queries
  • Alert search and filtering

Example prompts

  • “/alert-ledger”

What it can do on your machine

Read from SKILL.md and the folder at commit da14ae9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Alert Ledger loads about 469 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 158 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~469

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shepherdjerred/monorepo at commit da14ae9, republished under its GPL-3.0 licence (© shepherdjerred). 158 words, ~469 tokens.

Download SKILL.mdSave it as .claude/skills/alert-ledger/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
alert-ledger
description
Query the read-only Alerts occurrence ledger with `toolkit alerts`. Use for active-alert checks, historical opened or resolved range queries, alert search and filtering, or inspection of one occurrence's lifecycle events.

Alert Ledger

Use the repository's toolkit alerts command for operational alert history. The service is read-only: do not attempt acknowledgement, assignment, manual resolution, or silence changes through it.

Query occurrences

Run from the monorepo or use an installed toolkit binary:

bash
toolkit alerts list --state open
toolkit alerts list --severity critical --namespace storage
toolkit alerts list --search DiskFull --json
toolkit alerts list --opened-from 2026-08-03T00:00:00Z --opened-to 2026-08-10T00:00:00Z
toolkit alerts list --resolved-from 2026-08-03T00:00:00Z --resolved-to 2026-08-10T00:00:00Z

Combine --state, --severity, --namespace, --alertname, --search, and the independent opened/resolved range flags as needed. Use RFC 3339 instants for range boundaries. Omit --limit to follow every API cursor; set it when a bounded result is sufficient. Prefer --json when another program will consume the result.

Inspect lifecycle evidence

Take an occurrence ID from the list output and inspect its timeline:

bash
toolkit alerts show <occurrence-id>
toolkit alerts show <occurrence-id> --json

Report lifecycle and suppression state separately. A resolved occurrence may have resolutionSource=webhook or resolutionSource=reconciled; do not infer acknowledgement or human action from either value.

Connection boundary

ALERT_DASHBOARD_URL overrides the default tailnet endpoint. An unavailable endpoint is an operational error, not evidence that no alerts exist. Alerts is the sole active alert destination; use toolkit alerts for the service.

© shepherdjerred, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in packages/toolkit/skills/alert-ledger of shepherdjerred/monorepo.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit da14ae9

Compare with similar skills

Alert Ledger next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Alert Ledger compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Alert Ledger this skillshepherdjerred/monorepo112—~469Automated safety check: PassGPL-3.0
Alerting Oncallsickn33/agentic-awesome-skills47k1 repos~2.8kAutomated safety check: PassMIT
Health Alert Authoringnetdata/netdata81k—~7.1kAutomated safety check: PassGPL-3.0
Recursive Decision Ledgeraffaan-m/ECC275k1 repos~701Automated safety check: PassMIT
Gke Alert Configurationgoogle/skills21k—~5.3kAutomated safety check: PassApache-2.0
Implementing Vulnerability Sla Breach Alertingmukul975/Anthropic-Cybersecurity-Skills34k—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Alerting Oncall

    sickn33/agentic-awesome-skills

    Set up alerting rules, configure on-call rotations, and manage incident response workflows.

    47k GitHub starsUsed in 1 repo~2.8k tokens
    DevOps & CloudAuto-check passed
  • Health Alert Authoring

    netdata/netdata

    Author, adapt, modify, or review Netdata health alerts and alert templates.

    81k GitHub stars~7.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Run repeated rollouts ("Prime Gauss" style recursive prompting) while keeping an append-only decision ledger of trials, marks, coherence checks, and promotion gates, so recursive confidence never…

    275k GitHub starsUsed in 1 repo~701 tokens
    Business, Finance & HRAuto-check passed
  • Official

    Configures alerting policies in Terraform for Google Kubernetes Engine (GKE) clusters, workloads, and services using PromQL and Google Cloud Managed Service for Prometheus.

    21k GitHub stars~5.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Implementing Vulnerability Sla Breach Alerting

    mukul975/Anthropic-Cybersecurity-Skills

    Build an automated SLA breach alerting system for vulnerability remediation, including a database schema for SLA tracking, breach detection logic, notification dispatch, a scheduled check runner…

    34k GitHub stars~2.6k tokensUpdated 1 mo ago
    DatabasesAuto-check passed
  • Party Ledger Reconciliation

    sickn33/agentic-awesome-skills

    Party ledger reconciliation: party type, name and PAN/VAT, ledger against statement balance, difference and reason, duplicates, confirmation status and adjustment.

    47k GitHub starsUsed in 1 repo~5.2k tokens
    Business, Finance & HRAuto-check passed

More from shepherdjerred/monorepo

All 63 skills in this repo
  • Bun Runtime Best Practices

    shepherdjerred/monorepo

    Bun runtime APIs and current operational patterns for files, processes, modules, networking, databases, tests, and deployment.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Bun Test Patterns

    shepherdjerred/monorepo

    Current Bun test runner guidance for discovery, isolation, parallelism, sharding, changed tests, mocks, timers, snapshots, coverage, DOM Testing Library, and integration teardown.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Bun Workspaces

    shepherdjerred/monorepo

    Current Bun workspace guidance for isolated and hoisted linkers, catalogs, filters, scripts, dependency classes, lockfiles, lifecycle trust, caches, publishing, TypeScript package exports, and…

    112 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Deep Research

    shepherdjerred/monorepo

    This skill should be used when the user asks to "deep research", "research this topic", "investigate thoroughly", "do a deep dive on", "comprehensive research on", "find everything about", "survey…

    112 GitHub stars~4.7k tokensUpdated today
    Auto-check: notes
  • Figma Use

    shepherdjerred/monorepo

    This skill should be used when the user asks to "create a Figma design", "design in Figma", "make a Figma mockup", "create an app icon", "design UI", "render JSX to Figma", "export from Figma"…

    112 GitHub stars~946 tokensUpdated today
    Auto-check passed
  • Fish Helper

    shepherdjerred/monorepo

    Current Fish shell scripting, functions, abbreviations, completions, variables, events, configuration, plugins, testing, and safety guidance.

    112 GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Alert Ledger

What does Alert Ledger do?

Query the read-only Alerts occurrence ledger with toolkit alerts. Alert Ledger is an agent skill from shepherdjerred/monorepo. Query the read-only Alerts occurrence ledger with toolkit alerts.

When should I use Alert Ledger?

Alert Ledger fits situations like: active-alert checks; historical opened; resolved range queries; alert search and filtering.

How do I install Alert Ledger in Claude Code?

Run `npx skills add shepherdjerred/monorepo --skill alert-ledger -a claude-code`. Or copy the skill folder (packages/toolkit/skills/alert-ledger in shepherdjerred/monorepo) into .claude/skills/alert-ledger in your project. Claude Code loads it when a task matches its description.

How do I install Alert Ledger in Codex?

Run `npx skills add shepherdjerred/monorepo --skill alert-ledger -a codex`. Or copy the skill folder (packages/toolkit/skills/alert-ledger in shepherdjerred/monorepo) into .agents/skills/alert-ledger in your project. Codex loads it when a task matches its description.

Can I use Alert Ledger in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shepherdjerred/monorepo --skill alert-ledger -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/alert-ledger, .gemini/skills/alert-ledger, .github/skills/alert-ledger and .opencode/skills/alert-ledger in your project.

What does Alert Ledger need to run?

SKILL.md names no scripts, command-line tools or credentials: Alert Ledger is instructions for the agent only.

Does Alert Ledger access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Alert Ledger safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Alert Ledger use?

Alert Ledger is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Alert Ledger use?

About 469 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Alert Ledger?

Skills that share tags, products or a category with Alert Ledger: Alerting Oncall (sickn33/agentic-awesome-skills, 47k stars), Health Alert Authoring (netdata/netdata, 81k stars), Recursive Decision Ledger (affaan-m/ECC, 275k stars) and Gke Alert Configuration (google/skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Alert Ledger?

shepherdjerred (a GitHub user) maintains it in shepherdjerred/monorepo, which has 112 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 8, 2026.

Source: shepherdjerred/monorepo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.