netalertx-idempotent-setup
Performs a clean, idempotent reset and reprovision of the local development container environment.
Install
mkdir -p .claude/skills/netalertx-idempotent-setup && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/3446" && unzip -o skill.zip -d .claude/skills/netalertx-idempotent-setup && rm skill.zipInstalls to .claude/skills/netalertx-idempotent-setup
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Reprovision and reset the devcontainer environment. Use this when asked to re-run startup, reprovision, setup devcontainer, fix permissions, or reset runtime state.Key capabilities
- →Kill active system services
- →Recreate critical directory structures
- →Reset symbolic links and configuration files
- →Force service restart via entrypoint scripts
How it works
Runs an idempotent script that destroys existing runtime state and forces a fresh initialization of all service files and symlinks.
Inputs & outputs
When to use netalertx-idempotent-setup
- →Fix broken devcontainer state
- →Reset runtime environment after rebuild
- →Re-run setup scripts after configuration changes
About this skill
Devcontainer Setup
The setup script forcefully resets all runtime state (services, tmpfs ramdisks, symlinks, log files) unconditionally on every run. Persistent DB/config content under /data is the one exception - it's preserved by default; see step 7 below.
Command
/workspaces/NetAlertX/.devcontainer/scripts/setup.sh
What It Does
- Kills all services (php-fpm, nginx, crond, python3)
- Mounts tmpfs ramdisks for
/tmp/log,/tmp/api,/tmp/run,/tmp/nginx - Creates critical subdirectories
- Links
/entrypoint.dand/appsymlinks - Creates
/data,/data/config,/data/dbdirectories - Creates all log files
- Runs
/entrypoint.shto start services - by default this preserves existing DB/config content;entrypoint.d/25-first-run-db.shand20-first-run-config.shonly wipe them whenALWAYS_FRESH_INSTALL=trueis set in the environment - Writes version to
.VERSION
When to Use
- After modifying setup scripts
- After container rebuild
- When environment is in broken state
- To pick up a database/config reset done another way (setup.sh itself won't reset them - see step 7)
Philosophy
Runtime state (services, tmpfs, symlinks, logs) has no conditional logic - everything is recreated unconditionally, every run. DB/config are the one deliberate exception, gated behind ALWAYS_FRESH_INSTALL. If something in runtime state doesn't work, run setup again.
When not to use it
- →Production environments where uptime is critical
- →Situations where current runtime state must be preserved
Prerequisites
Limitations
- →Wipes all current runtime data/cache
- →Destructive to existing service state
How it compares
Performs an unconditional total reset instead of trying to patch a broken environment.
Compared to similar skills
netalertx-idempotent-setup side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| netalertx-idempotent-setup (this skill) | 1 | 8mo | Review | Beginner |
| bazel-build-optimization | 14 | 4mo | No flags | Advanced |
| linux-production-shell-scripts | 7 | 8mo | Review | Intermediate |
| machine-learning-ops-ml-pipeline | 4 | 5mo | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by netalertx
View all by netalertx →You might also like
bazel-build-optimization
wshobson
Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.
linux-production-shell-scripts
davila7
This skill should be used when the user asks to "create bash scripts", "automate Linux tasks", "monitor system resources", "backup files", "manage users", or "write production shell scripts". It provides ready-to-use shell script templates for system administration.
machine-learning-ops-ml-pipeline
sickn33
Design and implement a complete ML pipeline for: $ARGUMENTS
windows-builder
hashicorp
Build Windows images with Packer using WinRM communicator and PowerShell provisioners. Use when creating Windows AMIs, Azure images, or VMware templates.
cicd-automation-workflow-automate
sickn33
You are a workflow automation expert specializing in creating efficient CI/CD pipelines, GitHub Actions workflows, and automated development processes. Design automation that reduces manual work, improves consistency, and accelerates delivery while maintaining quality and security.
create-worktree-skill
disler
Use when the user explicitly asks for a SKILL to create a worktree. If the user does not mention "skill" or explicitly request skill invocation, do NOT trigger this. Only use when user says things like "use a skill to create a worktree" or "invoke the worktree skill". Creates isolated git worktrees with parallel-running configuration.