
Description
Guides developers building Datadog Apps with TypeScript, React, the @datadog/apps scaffolder, and @datadog/vite-plugin. Use when a user wants to scaffold, run, debug, upgrade, build, upload, publish, upload without publishing (draft upload), add an upload-no-publish script, set up CI/CD, use OAuth or API/application key auth, trigger/poll Workflow Automation, choose DDSQL or Action Catalog for backend data access, or query app datastores with DDSQL, including backend function troubleshooting.
SKILL.md
Datadog Apps
Use this skill when a developer is building a Datadog Apps project with TypeScript, React, published packages, and the normal production Datadog site. If the user is modifying Datadog platform packages or testing package source changes, use a platform-engineer-oriented workflow instead.
Overview
Datadog Apps are locally developed web apps built with React and TypeScript or JavaScript. Use Apps when a project needs source control, code review, CI/CD, multi-engineer collaboration, AI-assisted local development, custom UI or logic, or backend code that integrates with services beyond low-code App Builder. Apps share App Builder's permissions model and can be embedded in Datadog surfaces such as dashboards and the Internal Developer Portal.
Reference Routing
Read only the reference needed for the user's task:
| User task | Read |
|---|---|
| Create, scaffold, configure prerequisites, or run locally | references/getting-started.md |
| Build, upload, publish, upload without publishing, add upload-no-publish script, configure Datadog site, or understand upload output | references/build-upload-publish.md |
| Add or update GitHub Actions deployment | references/cicd.md |
| Trigger or poll Workflow Automation from a backend function | references/workflow-http-trigger.md |
| Get started querying data from a Datadog App | references/querying-data/getting-started.md |
| Understand or configure Action Catalog connections | references/querying-data/connections.md |
| Query Datadog App datastores with DDSQL | references/querying-data/ddsql/datastores.md |
| Upgrade Datadog Apps dependencies or compare with a freshly scaffolded app | references/upgrading.md |
| Diagnose OAuth, API/application key auth, upload, Node, site, or backend function failures | references/troubleshooting.md |
Boundaries
- After scaffolding or when working inside an existing app, read the app project's
AGENTS.mdbefore making changes. - For backend function implementation details, rely on the generated app project's
AGENTS.md; this skill only covers local development auth choices and troubleshooting. - Preserve the app project's existing package manager, scripts, Datadog site, and repository conventions.
- Do not cover Datadog package/platform development in this skill.
- Low-code App Builder to Datadog Apps migration guidance is future work. Do not invent a migration process yet.
More skills from the agent-skills repository
View all 34 skillsagent-install
install Datadog Agent on Kubernetes
Apr 15DatadogDeploymentKubernetesObservabilityagent-observability-auto-experiment
run iterative code improvements using Datadog data
Jul 31DatadogDebuggingEvalsLLM +1agent-observability-eval-bootstrap
bootstrap evaluators from production traces
Jun 19DatadogEvalsLLMObservabilityagent-observability-eval-pipeline
run agent observability and evaluation pipelines
Jun 19AgentsData PipelineDatadogEvals +1agent-observability-experiment-analyzer
analyze LLM experiment results
Jun 19AnalyticsDatadogEvalsLLM +1agent-observability-experiment-py-bootstrap
generate Python experiment clients for LLM observability
Jun 19DatadogJupyterLLMObservability +1
More from Datadog Labs
View publisheragent-observability-replay-trace
iterate on LLM traces with local code
agent-skills
Jul 31DatadogDebuggingLLMObservability +1agent-observability-session-classify
evaluate user intent satisfaction in sessions
agent-skills
Jun 19AnalyticsDatadogEvalsLLM +1agent-observability-trace-rca
diagnose LLM application failures from traces
agent-skills
Jun 19DatadogDebuggingEvalsLLM +1agent-skills
use Datadog observability skills
agent-skills
Apr 6DatadogMonitoringObservabilitydd-apm
query Datadog APM traces
agent-skills
Apr 6DatadogDistributed TracingObservabilityPerformance