M
modal-web-scheduling-knowledge
About modal-web-scheduling-knowledge
A reference skill for developers building Modal HTTP endpoints and scheduled jobs. It helps route implementation choices, local testing, deployment, and debugging without covering Modal compute or storage.
Key features
- 01HTTP endpoint routing guidance
- 02Cron and interval scheduling
- 03Local serve and deployment workflow
- 04Retries, timeouts, and idempotency guidance
- 05Deployment and log debugging checklist
Use cases
- 01Choosing an endpoint decorator for an API
- 02Setting up recurring ETL jobs
- 03Testing and deploying a Modal app
- 04Diagnosing schedule or endpoint configuration issues
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/modal-web-scheduling-knowledgein Claude Code to confirm it loaded.
Details
From the project READMEModal Web and Scheduling Knowledge
Use this skill for Modal web endpoints and scheduled jobs. For GPU compute, autoscaling, or storage primitives, use the focused Modal compute or storage skills.
Endpoint routing
- Use
@modal.fastapi_endpoint()for simple function-backed HTTP APIs. - Use
@modal.asgi_app()for full FastAPI/Starlette apps, WebSockets, middleware, and routing. - Use
@modal.wsgi_app()for WSGI frameworks. - Add
@modal.concurrentfor high-throughput endpoints that can safely handle concurrent inputs per container. - Test locally with
modal serve, then deploy withmodal deploy.
Scheduling routing
- Use
modal.Cron(...)for calendar schedules and explicit timezones. - Use
modal.Period(...)for interval-based execution. - Schedules run from deployed apps;
modal runis only for manual testing. - Add retries, timeouts, and idempotency for scheduled ETL or recurring jobs.
Debug checklist
- Confirm the app is deployed when testing schedules.
- Check endpoint logs with bounded log streaming.
- Validate secrets and environment names before deployment.
- Exercise a minimal request or manual schedule trigger before scaling traffic.
Comments
Markdown supported