Skip to content
Skills Library
DevOps & cloud · Automation

local-dev-environment

/local-dev-environment

Start, stop, or check status of local dev environment using Podman Compose. Database, app services, migrations, health checks. Use when user says "start local env", "podman compose up", "dev environment status".

Repository
skills ↗
Licence
Apache-2.0
Last repository change
27.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Start, stop, or check status of local dev environment using Podman Compose. Database, app services, migrations, health checks. Use when user says "start local env", "podman compose up", "dev environment status".

Triggers from the description

start local envpodman compose updev environment status
Original author description

Start, stop, or check status of local dev environment using Podman Compose. Database, app services, migrations, health checks. Use when user says "start local env", "podman compose up", "dev environment status".

How it works

  1. Inputs
  2. Persona
  3. Workflow
  4. Quick Actions
Original SKILL.md headings · 58 lines, 267 words
SKILL.md preview
---
name: local-dev-environment
description: Start, stop, or check status of local dev environment using Podman Compose. Database, app services, migrations, health checks. Use when user says "start local env", "podman compose up", "dev environment status".
---

# Local Dev Environment

Start, stop, or check status of local development environment using Podman Compose.

## Inputs

| Input | Type | Default | Purpose |
|-------|------|---------|---------|
| `repo` | string | required | Path to repo with podman-compose.yaml |
| `action` | string | "status" | start, stop, status, restart |
| `run_migrations` | bool | false | Run DB migrations after start |
| `health_check` | bool | true | Run health check after start |

## Persona

Load **devops** persona (podman, systemd). May need **developer** for curl; **database** for psql.

## Workflow

### 1. Bootstrap
- `persona_load("devops")` — podman tools
- `systemctl_is_active(unit="podman.socket")` — ensure Podman socket active

### 2. Current Status
- `podman_compose_status(project_dir=repo)` — compose status
- `podman_ps()` — running containers

### 3. Perform Action
- If action in [stop, restart]: `podman_compose_down(project_dir=repo)`
- If action in [start, restart]: `podman_compose_up(project_dir=repo, detach=true)`

### 4. Post-Start (if action != status)
- `podman_compose_status(project_dir=repo)` — verify status
- `podman_logs(container="{repo_basename}-app-1", tail=30)` — recent logs

### 5. Database
- If run_migrations and action in [start, restart]: `podman_exec(container="{repo_basename}-app-1", command="python manage.py migrate")`
- `psql_tables()` — list tables (verify DB ready)
- `psql_query(query="SELECT 1 as health_check;")` — connectivity

### 6. Health Check (if health_check)
- `curl_get(url="http://localhost:8000/api/v1/health/")` — API health
- `curl_timing(url="http://localhost:8000/api/v1/health/")` — response time

### 7. Error Handling
- On "port already in use": stop conflicting process or `podman_compose_down` first
- On "connection refused": wait for container startup, check `podman_logs`

### 8. Session Log
- `memory_session_log("Local dev environment: {action}", "repo={repo}")`

## Quick Actions

- View logs: `podman_logs(container="<name>", tail=50)`
- Run migrations: include `run_migrations: true` in inputs
- Restart: `skill_run("local_dev_environment", '{"repo": "...", "action": "restart"}')`

Versions

The database has no other skills named local-dev-environment.

Database snapshot: 13.11.2026 · package version 1ca43bb6da69 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100podman
    Use when the user asks about Podman, rootless containers, Quadlet/systemd units, Podman Compose, or migrating Docker workflows to Podman. Creates and manages rootless Podman containers, maps Docker commands, configures podman run/build/compose flows, and sets up systemd-managed services.
  • 100pave-env
    Set up local development environments — devcontainers, Docker Compose, one-command setup, dev/prod parity. Use when asked to "set up dev environment", "devcontainer", "docker compose for dev", "local development setup", or "one command to run".
  • 90rhdh-local
    Operates a local Red Hat Developer Hub environment with the rhdh-local-setup customization system: enable or disable dynamic plugins, apply configuration, switch pristine and customized modes, start or stop containers, inspect health and logs, run plugin verification, and back…
  • 100docker-compose
    Docker Compose for multi-container apps. Covers services, networks, and volumes. Use for local development environments. USE WHEN: user mentions "docker-compose", "docker-compose.yml", "multi-container", "service dependencies", "docker compose up", asks about "local dev…
  • 100podman
    Expert Podman container engine assistance covering rootless containers, podman-compose, pod generation (Kubernetes YAML), and systemd integration. Use when managing secure, daemonless OCI containers on Linux.
  • 90docker-dev
    Assistance with Local Development using Docker (Compose, DevContainers). Use when: docker, compose, local dev, devcontainer, dev environment, containerize, dockerization.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.