How do I install the Tilt Dev skill?

Run npx skillmds@latest add liatrio-labs/tilt-dev 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 Tilt Dev safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tilt Dev?

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 Tilt Dev free to use?

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

Who published Tilt Dev?

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

Tilt Dev by liatrio-labs — Agent Skill

Name: Tilt Dev
Author: liatrio-labs

Tilt Dev

Manage local development environments with Tilt. Use when working with projects that run services via Tilt (indicated by presence of Tiltfile), including checking service status, viewing logs, troubleshooting connectivity issues, or managing the Tilt stack. Essential for projects using Tiltfile with local_resource for orchestrating backend, frontend, and other services.

liatrio-labs 2d2b94f 4 files · 7.6 KB Updated Sep 17, 2026

File contents

Tilt Development Environment Management

Manage and troubleshoot local development stacks orchestrated by Tilt.

Quick Start

Script paths shown as scripts/... assume your current working directory is skills/tilt-dev/. From repo root, use skills/tilt-dev/scripts/....

Check if Services Are Running

Always check before starting Tilt:

# Run status check script
scripts/check_tilt_status.sh [port]

# Or manually
tilt get uiresources --port <PORT>

Check Service Health

# Run health check script
scripts/get_service_health.sh

# Or manually check endpoints
curl http://localhost:3000/health     # Backend
curl http://localhost:3001/           # Frontend
curl http://localhost:4111/swagger-ui # Mastra

Start Tilt

Only if services are not already running:

tilt up --port <PORT>

Common ports: 10102, 10301, 10350

View Logs

tilt logs --port <PORT> <resource>

# Follow logs
tilt logs --port <PORT> <resource> --follow

Stop Tilt

tilt down

Important Principles

Always Check First

Services are likely already running with hot reload. Never blindly run tilt up without checking status first.

Prefer Health Checks Over Restarts

Check health endpoints and logs before restarting services. Tilt hot-reloads changes automatically.

Use the Tilt UI

Access at http://localhost:<PORT> for:

Real-time resource status
Build logs
Service restarts
Error messages

Common Workflows

Debug Service Not Responding

Check Tilt UI resource status
View resource logs: tilt logs --port <PORT> <resource>
Check health endpoint with curl
Review error messages in logs

View Recent Errors

# Tail logs for specific service
tilt logs --port <PORT> <resource> | tail -50

# Follow logs in real-time
tilt logs --port <PORT> <resource> --follow

Diagnose Tilt Issues

tilt doctor

Reference

See references/tilt_commands.md for:

Complete command reference
Tiltfile (Starlark) syntax guidelines
Project-specific examples
Troubleshooting guide
Port conventions

Scripts

scripts/check_tilt_status.sh [port] - Check if Tilt is running and list resources
scripts/get_service_health.sh - Check health endpoints for common services

---name: tilt-devdescription: Manage local development environments with Tilt. Use when working with projects that run services via Tilt (indicated by presence of Tiltfile), including checking service status, viewing logs, troubleshooting connectivity issues, or managing the Tilt stack. Essential for projects using Tiltfile with local_resource for orchestrating backend, frontend, and other services.---# Tilt Development Environment ManagementManage and troubleshoot local development stacks orchestrated by Tilt.## Quick StartScript paths shown as `scripts/...` assume your current working directory is `skills/tilt-dev/`. From repo root, use `skills/tilt-dev/scripts/...`.### Check if Services Are RunningAlways check before starting Tilt:```bash# Run status check scriptscripts/check_tilt_status.sh [port]# Or manuallytilt get uiresources --port <PORT>```### Check Service Health```bash# Run health check scriptscripts/get_service_health.sh# Or manually check endpointscurl http://localhost:3000/health # Backendcurl http://localhost:3001/ # Frontendcurl http://localhost:4111/swagger-ui # Mastra```### Start TiltOnly if services are not already running:```bashtilt up --port <PORT>```Common ports: 10102, 10301, 10350### View Logs```bashtilt logs --port <PORT> <resource># Follow logstilt logs --port <PORT> <resource> --follow```### Stop Tilt```bashtilt down```## Important Principles### Always Check FirstServices are likely already running with hot reload. Never blindly run `tilt up` without checking status first.### Prefer Health Checks Over RestartsCheck health endpoints and logs before restarting services. Tilt hot-reloads changes automatically.### Use the Tilt UIAccess at `http://localhost:<PORT>` for:- Real-time resource status- Build logs- Service restarts- Error messages## Common Workflows### Debug Service Not Responding1. Check Tilt UI resource status2. View resource logs: `tilt logs --port <PORT> <resource>`3. Check health endpoint with curl4. Review error messages in logs### View Recent Errors```bash# Tail logs for specific servicetilt logs --port <PORT> <resource> | tail -50# Follow logs in real-timetilt logs --port <PORT> <resource> --follow```### Diagnose Tilt Issues```bashtilt doctor```## ReferenceSee [references/tilt_commands.md](references/tilt_commands.md) for:- Complete command reference- Tiltfile (Starlark) syntax guidelines- Project-specific examples- Troubleshooting guide- Port conventions## Scripts- `scripts/check_tilt_status.sh [port]` - Check if Tilt is running and list resources- `scripts/get_service_health.sh` - Check health endpoints for common services

Frequently asked questions