scorecards

Manage Datadog Service Scorecards rules, outcomes, and service compliance evaluations via the pup CLI.

5|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/lauhon/pi --skill scorecards-lauhon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scorecards
Source: https://github.com/lauhon/pi/tree/main/skills/scorecards
Command: npx skills add https://github.com/lauhon/pi --skill scorecards-lauhon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tracking whether services meet organizational standards for security, reliability, and observability is difficult to do manually across a large service catalog. This Skill lets you define scoring rules, record pass/fail/skip outcomes, and monitor compliance against Datadog Service Scorecards directly through the pup CLI. ## Core Features & Use Cases - Rules Management: List, create, update, and delete custom scorecard rules, with filtering by name, scorecard, or enabled status. - Outcomes Management: View evaluation results per service and set outcomes in batch, either synchronously or asynchronously. - Compliance Tracking: Evaluate services against built-in scorecards (Production Readiness, Observability Best Practices, Ownership & Documentation) or custom scorecards. - Use Case: A platform engineer wants to find all services failing Production Readiness checks, then create a custom rule requiring automated deployments and record pass/fail outcomes for each service with explanatory remarks. ## Quick Start Ask the agent to list all scorecard rules and show which services are currently failing their evaluations.

Frequently Asked Questions about scorecards

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

FAQPage Schema
How do I create a custom Datadog scorecard rule?

Run pup scorecards rules create with a name, description, target scorecard, and enabled flag. New rules should start disabled, be tested, then enabled. Creating rules requires the apm_service_catalog_write scope on your application key.

How do I check which services are failing scorecard rules?

Run pup scorecards outcomes list with the --state=fail filter to see all failing evaluations. You can also filter by service name or rule ID, and add --include-rule to see full rule details alongside each outcome.

What permissions does the Datadog Scorecards API require?

Listing rules and outcomes requires an application key with the apm_service_catalog_read scope. Creating or updating rules and outcomes requires apm_service_catalog_write. You also need DD_API_KEY and DD_SITE environment variables set.

Can I delete built-in Datadog scorecard rules?

No, built-in scorecard rules cannot be deleted; they can only be disabled. Only custom rules you created can be removed with pup scorecards rules delete, which requires explicit confirmation due to data loss.

What is the difference between fail and skip outcome states?

Fail means the service does not meet the rule criteria, while skip means the rule is not applicable to that service. Use skip to exclude services from specific rules without lowering their overall scorecard score.

Why do I get a 403 Forbidden error with scorecards commands?

A 403 error means your Datadog application key lacks the required scope. Ensure the key has apm_service_catalog_read for listing operations or apm_service_catalog_write for creating and updating rules and outcomes.