netalertx / about-netalertx-project-structure

Install for your project team

Run this command in your project directory to install the skill for your entire team:

mkdir -p .claude/skills/about-netalertx-project-structure && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/2648" && unzip -o skill.zip -d .claude/skills/about-netalertx-project-structure && rm skill.zip

New-Item -Path ".claude/skills/about-netalertx-project-structure" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/2648" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath ".claude/skills/about-netalertx-project-structure" -Force; Remove-Item "skill.zip"

Project Skills

This skill will be saved in .claude/skills/about-netalertx-project-structure/ and checked into git. All team members will have access to it automatically.

Important: Please verify the skill by reviewing its instructions before using it.

Install skill for Codex

Run one of these commands to install the skill depending on your needs:

Project Local ($CWD/.codex/skills)

mkdir -p .codex/skills/about-netalertx-project-structure && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/2648" && unzip -o skill.zip -d .codex/skills/about-netalertx-project-structure && rm skill.zip

New-Item -Path ".codex/skills/about-netalertx-project-structure" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/2648" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath ".codex/skills/about-netalertx-project-structure" -Force; Remove-Item "skill.zip"

User Global (~/.codex/skills)

mkdir -p ~/.codex/skills/about-netalertx-project-structure && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/2648" && unzip -o skill.zip -d ~/.codex/skills/about-netalertx-project-structure && rm skill.zip

New-Item -Path "$HOME/.codex/skills/about-netalertx-project-structure" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/2648" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath "$HOME/.codex/skills/about-netalertx-project-structure" -Force; Remove-Item "skill.zip"

Scope	Location	Suggested Use
REPO	`$CWD/.codex/skills`	Project directory. Teams can check in skills most relevant to a working folder here.
REPO	`$CWD/../.codex/skills`	A folder above CWD. Organizations can check in skills relevant to a shared area.
REPO	`$REPO_ROOT/.codex/skills`	Top-most root folder. Relevant to everyone using the repository.
USER	`$CODEX_HOME/skills`	Personal folder (`~/.codex/skills`). Curate skills that apply to any repository.

Install skill for GitHub Copilot

Run one of these commands to install the skill depending on your needs:

Project (.github/skills)

mkdir -p .github/skills/about-netalertx-project-structure && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/2648" && unzip -o skill.zip -d .github/skills/about-netalertx-project-structure && rm skill.zip

New-Item -Path ".github/skills/about-netalertx-project-structure" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/2648" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath ".github/skills/about-netalertx-project-structure" -Force; Remove-Item "skill.zip"

Personal (~/.copilot/skills)

mkdir -p ~/.copilot/skills/about-netalertx-project-structure && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/2648" && unzip -o skill.zip -d ~/.copilot/skills/about-netalertx-project-structure && rm skill.zip

New-Item -Path "$HOME/.copilot/skills/about-netalertx-project-structure" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/2648" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath "$HOME/.copilot/skills/about-netalertx-project-structure" -Force; Remove-Item "skill.zip"

Scope	Location	Suggested Use
Project	`.github/skills/`	Repository-specific skills. Checked into git for the whole team.
Personal	`~/.copilot/skills/`	Personal skills available across all your projects.

Install skill for Google Antigravity

Run one of these commands to install the skill depending on your needs:

Workspace (.agent/skills)

mkdir -p .agent/skills/about-netalertx-project-structure && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/2648" && unzip -o skill.zip -d .agent/skills/about-netalertx-project-structure && rm skill.zip

New-Item -Path ".agent/skills/about-netalertx-project-structure" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/2648" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath ".agent/skills/about-netalertx-project-structure" -Force; Remove-Item "skill.zip"

Global (~/.gemini/antigravity/skills)

mkdir -p ~/.gemini/antigravity/skills/about-netalertx-project-structure && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/2648" && unzip -o skill.zip -d ~/.gemini/antigravity/skills/about-netalertx-project-structure && rm skill.zip

New-Item -Path "$HOME/.gemini/antigravity/skills/about-netalertx-project-structure" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://fastmcp.me/Skills/Download/2648" -OutFile "skill.zip"; Expand-Archive -Path "skill.zip" -DestinationPath "$HOME/.gemini/antigravity/skills/about-netalertx-project-structure" -Force; Remove-Item "skill.zip"

Scope	Location	Suggested Use
Workspace	`.agent/skills/`	Workspace-specific skills for project workflows and conventions.
Global	`~/.gemini/antigravity/skills/`	Personal skills available across all workspaces.

Navigate the NetAlertX codebase structure. Use this when asked about file locations, project structure, where to find code, or key paths.

Productivity Coding

0 views

0 installs

Source: https://github.com/netalertx/NetAlertX/tree/main/.github/skills/project-navigation

Skill Content

---
name: about-netalertx-project-structure
description: Navigate the NetAlertX codebase structure. Use this when asked about file locations, project structure, where to find code, or key paths.
---

# Project Navigation

## Key Paths

| Component | Path |
|-----------|------|
| Workspace root | `/workspaces/NetAlertX` |
| Backend entry | `server/__main__.py` |
| API server | `server/api_server/api_server_start.py` |
| Plugin system | `server/plugin.py` |
| Initialization | `server/initialise.py` |
| Frontend | `front/` |
| Frontend JS | `front/js/common.js` |
| Frontend PHP | `front/php/server/*.php` |
| Plugins | `front/plugins/` |
| Plugin template | `front/plugins/__template` |
| Database helpers | `server/db/db_helper.py` |
| Device model | `server/models/device_instance.py` |
| Messaging | `server/messaging/` |
| Workflows | `server/workflows/` |

## Architecture

NetAlertX uses a frontend–backend architecture: the frontend runs on **PHP + Nginx** (see `front/`), the backend is implemented in **Python** (see `server/`), and scheduled tasks are managed by a **supercronic** scheduler that runs periodic jobs.

## Runtime Paths

| Data | Path |
|------|------|
| Config (runtime) | `/data/config/app.conf` |
| Config (default) | `back/app.conf` |
| Database | `/data/db/app.db` |
| API JSON cache | `/tmp/api/*.json` |
| Logs | `/tmp/log/` |
| Plugin logs | `/tmp/log/plugins/` |

## Environment Variables

Use these NETALERTX_* instead of hardcoding paths. Examples:

- `NETALERTX_DB`
- `NETALERTX_LOG`
- `NETALERTX_CONFIG`
- `NETALERTX_DATA`
- `NETALERTX_APP`

## Documentation

| Topic | Path |
|-------|------|
| Plugin development | `docs/PLUGINS_DEV.md` |
| System settings | `docs/SETTINGS_SYSTEM.md` |
| API docs | `docs/API_*.md` |
| Debug guides | `docs/DEBUG_*.md` |

netalertx / about-netalertx-project-structure

Install for your project team

Download skill

Enable skills in Claude

Upload to Claude

Install skill for Codex

Install skill for GitHub Copilot

Install skill for Google Antigravity

Skill Content