Awesome-omni-skill managing-traefik

Manages Traefik reverse proxy for local development. Use when routing domains to local services, configuring CORS, checking service health, or debugging connectivity issues.

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data-ai/managing-traefik" ~/.claude/skills/diegosouzapw-awesome-omni-skill-managing-traefik && rm -rf "$T"

manifest: skills/data-ai/managing-traefik/SKILL.md

source content

Traefik Hub MCP

Local development reverse proxy management.

Quick Start

Generate Docker labels for a new service?

generate_labels name="myapp" domain="myapp.localhost" port=3000

Returns docker-compose label configuration to copy into your project.

Something not working?

doctor

Comprehensive health check with actionable tips.

Tool Categories

Project Setup

Tool	Use When
`generate_labels`	Creating docker-compose labels for Docker services

CORS Management

Tool	Use When
`get_cors`	Checking current allowed origins
`update_cors`	Adding/removing CORS origins

Health & Debugging

Tool	Use When
`doctor`	First step for any problem (comprehensive check)
`check_health`	Testing if specific domain responds
`check_setup`	Verifying MCP configuration

Inspection

Tool	Use When
`list_routers`	Seeing all configured routes
`list_services`	Seeing all backend services
`list_middlewares`	Seeing available middlewares
`get_router`	Getting details of specific route

Stack Control

Tool	Use When
`init_stack`	First time setup (creates network + starts Traefik)
`start_traefik`	Starting stopped Traefik
`stop_traefik`	Stopping Traefik
`create_network`	Creating traefik-public network only

Common Workflows

New Project Setup

1. generate_labels name="myapp" domain="myapp.localhost" port=3000
2. update_cors add=["http://myapp.localhost"]

Add the generated labels to your project's docker-compose.yml, then update CORS if needed.

Debug Service Not Reachable

1. doctor                           # Check all components
2. check_health domain="X.localhost" # Test specific domain
3. list_routers                     # Verify route exists
4. container_logs name="traefik"    # Check Traefik logs

Add CORS Origin

1. get_cors                         # See current origins
2. update_cors add=["http://newapp.localhost"]

Generate Docker Labels

generate_labels name="myapp" domain="myapp.localhost" port=3000

Returns docker-compose label configuration to copy into your project.

Decision Guide

Situation	Tool
First time ever	`init_stack`
New Docker service	`generate_labels`
CORS errors	`get_cors` → `update_cors`
Service unreachable	`doctor`
Check specific domain	`check_health`

Available Middlewares

Reference with

@file

suffix (e.g.,

cors-dev@file

```
cors-dev
```
- CORS headers for local development
```
secure-headers
```
- Security headers
```
rate-limit
```
- Rate limiting (100 req/s)
```
strip-api-prefix
```
- Strip
```
/api
```
prefix from path