Agent skill

Acarshub Socket Namespace

by sdr-enthusiasts in sdr-enthusiasts/docker-acarshub

Use ONLY when working in the docker-acarshub repository AND touching socket.io code -- emit / on / connect calls on either the React frontend or the Fastify backend.

GPL-3.0Auto-check passedDevOps & Cloud

Install Acarshub Socket Namespace

skills CLI
$ npx skills add sdr-enthusiasts/docker-acarshub --skill acarshub-socket-namespace -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sdr-enthusiasts/docker-acarshub acarshub-socket-namespace --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sdr-enthusiasts/docker-acarshub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/acarshub-socket-namespace .claude/skills/acarshub-socket-namespace && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
acarshub-socket-namespace
GitHub stars
117
Token cost
~710 tokens
SKILL.md length
276 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
GPL-3.0

At a glance

Use ONLY when working in the docker-acarshub repository AND touching socket.io code -- emit / on / connect calls on either the React frontend or the Fastify backend.

  • Tasks that involve Realtime and WebSockets
  • SKILL.md covers The pitfall, Events at a glance and When to stop and ask
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Containers

What it does

Acarshub Socket Namespace is an agent skill from sdr-enthusiasts/docker-acarshub. Use ONLY when working in the docker-acarshub repository AND touching socket.io code -- emit / on / connect calls on either the React frontend or the Fastify backend. Codifies the /main namespace binding that's done at construction time and the historical Flask-SocketIO-quirk pitfall: do NOT pass "/main" as an extra argument to socket.emit(...) calls.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Realtime and WebSockets and Containers. It works with Docker, Flask, Fastify and React. The repository describes itself as: Docker container to utilize RTLSDR dongle(s) to view/stream ACARS/VDLM2 aircraft data transmissions. The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Realtime and WebSockets
  • Tasks that involve Containers

Example prompts

  • “/acarshub-socket-namespace”

Requirements

  • Python 3
  • Docker

What it can do on your machine

Read from SKILL.md and the folder at commit 862da2a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Acarshub Socket Namespace loads about 710 tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 276 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~710

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sdr-enthusiasts/docker-acarshub at commit 862da2a, republished under its GPL-3.0 licence (© sdr-enthusiasts). 276 words, ~710 tokens.

Download SKILL.mdSave it as .claude/skills/acarshub-socket-namespace/SKILL.md (or your agent's skills folder).
name
acarshub-socket-namespace
description
Use ONLY when working in the docker-acarshub repository AND touching socket.io code -- emit / on / connect calls on either the React frontend or the Fastify backend. Codifies the `/main` namespace binding that's done at construction time and the historical Flask-SocketIO-quirk pitfall: do NOT pass `"/main"` as an extra argument to `socket.emit(...)` calls.

ACARS Hub: Socket.IO /main namespace is bound at construction

The frontend connects to the /main namespace at construction time:

typescript
const socket = io(`${origin}/main`, { ... });

The backend binds handlers via io.of("/main"). Once the constructor URL includes the namespace, all subsequent socket.emit(...) and socket.on(...) calls implicitly use it.

The pitfall

Do NOT pass "/main" as an extra argument to emits:

typescript
// Wrong -- the extra "/main" is silently consumed as a 2nd handler param
//         a future handler that adds a second parameter would silently
//         consume it and the bug would be invisible.
socket.emit("query_search", payload, "/main");

// Right
socket.emit("query_search", payload);

This pattern was a quirk of the Flask-SocketIO Python client that lived in the old Python backend. When the backend was ported to Node Socket.IO v4 (in tasks TYPE-01 / TYPE-02; commit pinned in agent-docs/REMEDIATION_PLAN.md), the trailing "/main" arguments became dead-but-harmless code. They were removed during that port. Do not re-introduce them, including in copy-pasted examples from older agent sessions, old git history, or documentation that predates the port.

Events at a glance

Backend -> frontend (frontend socket.on(...)):

  • acars_msg -- new ACARS message
  • adsb_aircraft -- ADS-B aircraft positions
  • system_status -- backend health status
  • terms -- alert term updates
  • database_search_results -- search results

Frontend -> backend (frontend socket.emit(...)):

  • query_search -- database search request
  • update_alerts -- update alert terms
  • request_status -- request system status

Full event catalogue (with payload shapes) is the responsibility of the typed acarshub-types package. When adding an event, add it there first, then on both ends.

When to stop and ask

  • A new event is needed that doesn't fit the existing patterns (e.g. a binary stream rather than a JSON-serialisable event). Surface the design choice before inventing a transport.
  • The event would push a payload over the Socket.IO default frame size. Confirm whether to bump the frame size or split the payload.
  • A handler genuinely needs to consume more than one positional parameter (very rare in Socket.IO v4 patterns). Stop -- this is exactly where the legacy "/main" arg becomes a real bug.

© sdr-enthusiasts, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .opencode/skills/acarshub-socket-namespace of sdr-enthusiasts/docker-acarshub.

Open the folder on GitHubat commit 862da2a

Compare with similar skills

Acarshub Socket Namespace next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Acarshub Socket Namespace compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Acarshub Socket Namespace this skillsdr-enthusiasts/docker-acarshub117—~710Automated safety check: PassGPL-3.0
Code PatternsAedelon/claude-code-blueprint120—~1.2kAutomated safety check: PassCustom licence
Web Ng Docker Loopcarverauto/serviceradar921—~737Automated safety check: PassApache-2.0
Tgf Server Devthkhxm/tgf128—~1.3kAutomated safety check: NotesMIT
Docker Containerizationailabs-393/ai-labs-claude-skills454—~2.1kAutomated safety check: NotesMIT
Modern Web GuidanceJetBrains/skills3663 repos~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Code Patterns

    Aedelon/claude-code-blueprint

    Reference patterns for REST APIs, pytest/vitest testing, Docker multi-stage builds, GitHub Actions CI/CD, PostgreSQL, TypeScript generics, Python async, and React Server Components.

    120 GitHub stars~1.2k tokensUpdated 7 mo ago
    DevOps & CloudAuto-check passed
  • Web Ng Docker Loop

    carverauto/serviceradar

    Run ServiceRadar elixir/web-ng locally against the Docker Compose CNPG database with copied mTLS certs and Docker secrets, then verify dashboard UI changes with Playwright.

    921 GitHub stars~737 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Tgf Server Dev

    thkhxm/tgf

    基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。

    128 GitHub stars~1.3k tokensUpdated 2 mo ago
    DatabasesAuto-check: notes
  • Docker Containerization

    ailabs-393/ai-labs-claude-skills

    This skill should be used when containerizing applications with Docker, creating Dockerfiles, docker-compose configurations, or deploying containers to various platforms.

    454 GitHub stars~2.1k tokensUpdated 11 mo ago
    DevOps & CloudAuto-check: notes
  • Modern Web Guidance

    JetBrains/skills

    Official

    Search tool for modern web development best practices. An agent skill from JetBrains/skills.

    366 GitHub starsUsed in 3 repos~1.4k tokens
    DevOps & CloudAuto-check passed
  • Production Agent Public

    OpenMinis/MinisSkills

    Production-grade ReAct Agent skill. An agent skill from OpenMinis/MinisSkills.

    444 GitHub stars~1.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from sdr-enthusiasts/docker-acarshub

  • Acarshub Design Language

    sdr-enthusiasts/docker-acarshub

    Use ONLY when working in the docker-acarshub repository AND building UI -- React components, SCSS modules, theme variables, accessibility, mobile responsiveness, Catppuccin color usage, Zustand…

    117 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Acarshub Tool Additions

    sdr-enthusiasts/docker-acarshub

    Use ONLY when working in the docker-acarshub repository AND a task may require adding a system tool, npm package, or other dependency.

    117 GitHub stars~707 tokensUpdated yesterday
    Auto-check passed

Questions about Acarshub Socket Namespace

What does Acarshub Socket Namespace do?

Use ONLY when working in the docker-acarshub repository AND touching socket.io code -- emit / on / connect calls on either the React frontend or the Fastify backend. Acarshub Socket Namespace is an agent skill from sdr-enthusiasts/docker-acarshub.io code -- emit / on / connect calls on either the React frontend or the Fastify backend.

When should I use Acarshub Socket Namespace?

Acarshub Socket Namespace fits situations like: tasks that involve Realtime and WebSockets; tasks that involve Containers.

How do I install Acarshub Socket Namespace in Claude Code?

Run `npx skills add sdr-enthusiasts/docker-acarshub --skill acarshub-socket-namespace -a claude-code`. Or copy the skill folder (.opencode/skills/acarshub-socket-namespace in sdr-enthusiasts/docker-acarshub) into .claude/skills/acarshub-socket-namespace in your project. Claude Code loads it when a task matches its description.

How do I install Acarshub Socket Namespace in Codex?

Run `npx skills add sdr-enthusiasts/docker-acarshub --skill acarshub-socket-namespace -a codex`. Or copy the skill folder (.opencode/skills/acarshub-socket-namespace in sdr-enthusiasts/docker-acarshub) into .agents/skills/acarshub-socket-namespace in your project. Codex loads it when a task matches its description.

Can I use Acarshub Socket Namespace in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sdr-enthusiasts/docker-acarshub --skill acarshub-socket-namespace -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/acarshub-socket-namespace, .gemini/skills/acarshub-socket-namespace, .github/skills/acarshub-socket-namespace and .opencode/skills/acarshub-socket-namespace in your project.

What does Acarshub Socket Namespace need to run?

SKILL.md names no scripts, command-line tools or credentials: Acarshub Socket Namespace is instructions for the agent only. Our summary lists: Python 3; Docker.

Does Acarshub Socket Namespace access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Acarshub Socket Namespace safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Acarshub Socket Namespace use?

Acarshub Socket Namespace is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Acarshub Socket Namespace use?

About 710 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Acarshub Socket Namespace?

Skills that share tags, products or a category with Acarshub Socket Namespace: Code Patterns (Aedelon/claude-code-blueprint, 120 stars), Web Ng Docker Loop (carverauto/serviceradar, 921 stars), Tgf Server Dev (thkhxm/tgf, 128 stars) and Docker Containerization (ailabs-393/ai-labs-claude-skills, 454 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Acarshub Socket Namespace?

sdr-enthusiasts (a GitHub organization) maintains it in sdr-enthusiasts/docker-acarshub, which has 117 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: sdr-enthusiasts/docker-acarshub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.