How do I install the Newrelic CLI Skills skill?

Run npx skillmds@latest add modbender/newrelic-cli-skills in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Newrelic CLI Skills safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: WARNING. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Newrelic CLI Skills?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Newrelic CLI Skills free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Newrelic CLI Skills?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Newrelic CLI Skills by modbender — Agent Skill

Name: Newrelic CLI Skills
Rating: 4.2 (5 reviews)
Author: modbender

Newrelic CLI Skills

Monitor, query, and manage New Relic observability data via the newrelic CLI. Covers NRQL queries, APM performance triage, deployment markers, alert management, infrastructure monitoring, and agent diagnostics. Use when user asks about application performance, error rates, slow transactions, deployment tracking, or New Relic configuration.

modbender Updated Sep 9, 2026 12 repo stars

File contents

New Relic CLI Skills

Quick Decision Tree

Performance issue reported? → apm/SKILL.md Need to query data with NRQL? → nrql/SKILL.md Recording a deployment? → deployments/SKILL.md Alert management? → alerts/SKILL.md Infrastructure/host issues? → infrastructure/SKILL.md Agent not reporting? → diagnostics/SKILL.md

Setup & Auth

# Install
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash

# Configure profile
newrelic profile add \
  --profile default \
  --apiKey $NEW_RELIC_API_KEY \
  --accountId $NEW_RELIC_ACCOUNT_ID \
  --region US   # or EU

newrelic profile default --profile default

# Verify
newrelic profile list

Common One-Liners

# Search for an entity by name
newrelic entity search --name "my-app"

# Run a NRQL query
newrelic nrql query --accountId $NEW_RELIC_ACCOUNT_ID \
  --query "SELECT average(duration) FROM Transaction WHERE appName='my-app' SINCE 1 hour ago"

# Record a deployment
newrelic apm deployment create \
  --applicationId <APP_ID> \
  --revision "v1.2.3" \
  --description "Feature: user auth"

# Run diagnostics
newrelic diagnose run

Entity Reference

Find entity GUIDs (needed for API calls and deployment markers):

# List all APM apps
newrelic entity search --name "" --type APPLICATION --domain APM

# Get specific entity details
newrelic entity get --guid <GUID>

# List all hosts
newrelic entity search --name "" --type HOST

Environment Variables

Variable	Description
`NEW_RELIC_API_KEY`	User key (NRAK-...)
`NEW_RELIC_ACCOUNT_ID`	Numeric account ID
`NEW_RELIC_REGION`	`US` or `EU`

Sub-Skills

Sub-skill	When to use
`apm/`	Performance triage, slow transactions, error analysis
`nrql/`	Custom queries, dashboards, ad-hoc data exploration
`deployments/`	Mark releases, correlate deploys with performance
`alerts/`	Alert policies, conditions, notification channels
`infrastructure/`	Host metrics, CPU/memory, process monitoring
`diagnostics/`	Agent health, config validation, connectivity

Scripts

Script	Purpose
`scripts/check-performance.sh`	Quick health check across all apps
`scripts/deployment-marker.sh`	Record a deployment event
`scripts/top-slow-transactions.sh`	Find the 10 slowest transactions
`scripts/error-report.sh`	Recent errors with stack traces

References

references/nrql-patterns.md — Common NRQL query patterns
references/performance-triage.md — Step-by-step triage guide

---name: newrelic-cli-skillsdescription: Monitor, query, and manage New Relic observability data via the newrelic CLI. Covers NRQL queries, APM performance triage, deployment markers, alert management, infrastructure monitoring, and agent diagnostics. Use when user asks about application performance, error rates, slow transactions, deployment tracking, or New Relic configuration.--- # New Relic CLI Skills ## Quick Decision Tree **Performance issue reported?** → [`apm/SKILL.md`](apm/SKILL.md) **Need to query data with NRQL?** → [`nrql/SKILL.md`](nrql/SKILL.md) **Recording a deployment?** → [`deployments/SKILL.md`](deployments/SKILL.md) **Alert management?** → [`alerts/SKILL.md`](alerts/SKILL.md) **Infrastructure/host issues?** → [`infrastructure/SKILL.md`](infrastructure/SKILL.md) **Agent not reporting?** → [`diagnostics/SKILL.md`](diagnostics/SKILL.md) --- ## Setup & Auth ```bash # Install curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash # Configure profile newrelic profile add \ --profile default \ --apiKey $NEW_RELIC_API_KEY \ --accountId $NEW_RELIC_ACCOUNT_ID \ --region US # or EU newrelic profile default --profile default # Verify newrelic profile list ``` --- ## Common One-Liners ```bash # Search for an entity by name newrelic entity search --name "my-app" # Run a NRQL query newrelic nrql query --accountId $NEW_RELIC_ACCOUNT_ID \ --query "SELECT average(duration) FROM Transaction WHERE appName='my-app' SINCE 1 hour ago" # Record a deployment newrelic apm deployment create \ --applicationId <APP_ID> \ --revision "v1.2.3" \ --description "Feature: user auth" # Run diagnostics newrelic diagnose run ``` --- ## Entity Reference Find entity GUIDs (needed for API calls and deployment markers): ```bash # List all APM apps newrelic entity search --name "" --type APPLICATION --domain APM # Get specific entity details newrelic entity get --guid <GUID> # List all hosts newrelic entity search --name "" --type HOST ``` --- ## Environment Variables | Variable | Description | |---|---| | `NEW_RELIC_API_KEY` | User key (NRAK-...) | | `NEW_RELIC_ACCOUNT_ID` | Numeric account ID | | `NEW_RELIC_REGION` | `US` or `EU` | --- ## Sub-Skills | Sub-skill | When to use | |---|---| | [`apm/`](apm/SKILL.md) | Performance triage, slow transactions, error analysis | | [`nrql/`](nrql/SKILL.md) | Custom queries, dashboards, ad-hoc data exploration | | [`deployments/`](deployments/SKILL.md) | Mark releases, correlate deploys with performance | | [`alerts/`](alerts/SKILL.md) | Alert policies, conditions, notification channels | | [`infrastructure/`](infrastructure/SKILL.md) | Host metrics, CPU/memory, process monitoring | | [`diagnostics/`](diagnostics/SKILL.md) | Agent health, config validation, connectivity | ## Scripts | Script | Purpose | |---|---| | [`scripts/check-performance.sh`](scripts/check-performance.sh) | Quick health check across all apps | | [`scripts/deployment-marker.sh`](scripts/deployment-marker.sh) | Record a deployment event | | [`scripts/top-slow-transactions.sh`](scripts/top-slow-transactions.sh) | Find the 10 slowest transactions | | [`scripts/error-report.sh`](scripts/error-report.sh) | Recent errors with stack traces | ## References - [`references/nrql-patterns.md`](references/nrql-patterns.md) — Common NRQL query patterns - [`references/performance-triage.md`](references/performance-triage.md) — Step-by-step triage guide

Frequently asked questions