modal

Deploy, debug, and monitor Modal serverless apps through the Modal CLI.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Claudfather/clauDNA --skill modal-claudfather
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: modal
Source: https://github.com/Claudfather/clauDNA/tree/main/skills/modal
Command: npx skills add https://github.com/Claudfather/clauDNA --skill modal-claudfather

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires modal.

What problem does it solve? Managing Modal serverless workloads requires juggling many CLI commands for deployment, log streaming, and workspace inspection, with no guardrails around destructive actions like production deploys. ## Core Features & Use Cases - Guided Deployments: Runs pre-deploy checks (git state, syntax validation, existing deployments), presents a summary, and requires explicit user confirmation before deploying with modal deploy. - Log Streaming & Debugging: Fetches app and container logs, executes diagnostic commands inside containers (nvidia-smi, py-spy), and helps investigate GPU OOM, heartbeat timeouts, and cold starts. - Workspace Dashboard: Surfaces apps, containers, secrets, volumes, and environments in a single read-only status view. - Use Case: After editing a Modal app file, ask to deploy it — the skill verifies authentication, summarizes what will change, waits for your confirmation, deploys with log streaming, then health-checks endpoints and reviews post-deploy logs. ## Quick Start Ask the assistant to deploy your Modal app, stream its logs, or show the workspace status, for example: deploy my Modal app to production.

Frequently Asked Questions about modal

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

FAQPage Schema
How do I deploy a Modal app to production?

Run the deploy mode, which checks git state and syntax, shows a pre-deploy summary, and asks for confirmation before running modal deploy with --stream-logs. It then health-checks endpoints and reviews post-deploy logs for errors.

How do I view and debug Modal app logs?

Use modal app logs <app-name> for app-level logs or modal container logs <container-id> for a specific container, optionally with --timestamps. For deeper debugging, exec into containers with nvidia-smi or py-spy, or open an interactive shell with modal shell.

What do I need installed before using Modal CLI commands?

You need the Modal CLI installed via pip install modal and an authenticated session. Verify with modal --version and modal token info; authenticate with modal token new or modal token set for headless environments.

Why does my Modal container get killed unexpectedly?

Common causes are GPU out-of-memory kills and heartbeat timeouts from a blocked GIL. Check GPU usage with modal container exec <id> -- nvidia-smi and profile the main process with py-spy dump --pid 1 inside a container shell.

Can I roll back a failed Modal deployment?

Yes, use modal app rollback <app-name> <version> to revert to a previous version, available on Team and Enterprise plans. Use modal app history <app-name> --json to find the target version number first.