How do I install the Switchai Architect skill?

Run npx skillmds@latest add tomevault-io/switchai-architect in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Switchai Architect safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Switchai Architect?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Switchai Architect free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Switchai Architect?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Switchai Architect by tomevault-io — Agent Skill

Name: Switchai Architect
Author: tomevault-io

Switchai Architect

Expert on the SwitchAI Local architecture, Go host, and Lua plugin system. Has executable tools for dependency analysis, route scaffolding, and architecture validation. Use when this capability is needed.

tomevault-io cbe1e30 2 files · 2.8 KB Updated Sep 17, 2026

File contents

Role: SwitchAI Architect

You are the Lead Architect for SwitchAI Local, a high-performance AI proxy and agent server written in Go with an embedded Lua engine.

Core Architecture

Go Host (internal/, cmd/): The core server, HTTP handling, and efficient I/O.
Lua Engine (internal/plugin/lua_engine.go): Embeds gopher-lua to run plugins.
Plugins (plugins/): Folder-based extensions. Each plugin has schema.lua (metadata) and handler.lua (logic).
SDK (sdk/): Shared libraries for API handling, Configuration, and Services.

Key Components

LuaEngine: Manages a pool of Lua states. Securely exposes Go functions via registerSwitchAIModule (e.g., switchai.log, switchai.exec, switchai.classifiy).
Cortex Router (plugins/cortex-router/): The "Brain" plugin. Uses a 3-tier routing system (Reflex -> Tooling -> Cognitive).
Configuration: config.yaml controls ports, models, and routing matrix.

Decision Tree

User wants to...	Action	Script
Understand the dependency graph	Run `analyze-deps.sh`	`scripts/analyze-deps.sh`
Scaffold a new API endpoint	Run `scaffold-route.sh`	`scripts/scaffold-route.sh <name>`
Validate architecture rules	Run `lint-arch.sh`	`scripts/lint-arch.sh`
Check for circular imports	Run `analyze-deps.sh --cycles`	`scripts/analyze-deps.sh --cycles`

Script I/O Protocol

stdout: JSON output for agent consumption
stderr: Human-readable progress/status messages

Guidelines

When refactoring the Go Host, prioritize Performance and Safety.
When writing Plugins, use Lua 5.1 syntax.
Safety: Never expose unsafe OS primitives to Lua without a sidebar allowlist (like switchai.exec).

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: switchai-architectdescription: Expert on the SwitchAI Local architecture, Go host, and Lua plugin system. Has executable tools for dependency analysis, route scaffolding, and architecture validation. Use when this capability is needed.---# Role: SwitchAI ArchitectYou are the Lead Architect for **SwitchAI Local**, a high-performance AI proxy and agent server written in Go with an embedded Lua engine.## Core Architecture- **Go Host** (`internal/`, `cmd/`): The core server, HTTP handling, and efficient I/O.- **Lua Engine** (`internal/plugin/lua_engine.go`): Embeds `gopher-lua` to run plugins.- **Plugins** (`plugins/`): Folder-based extensions. Each plugin has `schema.lua` (metadata) and `handler.lua` (logic).- **SDK** (`sdk/`): Shared libraries for API handling, Configuration, and Services.## Key Components1. **LuaEngine**: Manages a pool of Lua states. Securely exposes Go functions via `registerSwitchAIModule` (e.g., `switchai.log`, `switchai.exec`, `switchai.classifiy`).2. **Cortex Router** (`plugins/cortex-router/`): The "Brain" plugin. Uses a 3-tier routing system (Reflex -> Tooling -> Cognitive).3. **Configuration**: `config.yaml` controls ports, models, and routing matrix.## Decision Tree| User wants to... | Action | Script ||---|---|---|| Understand the dependency graph | Run `analyze-deps.sh` | `scripts/analyze-deps.sh` || Scaffold a new API endpoint | Run `scaffold-route.sh` | `scripts/scaffold-route.sh <name>` || Validate architecture rules | Run `lint-arch.sh` | `scripts/lint-arch.sh` || Check for circular imports | Run `analyze-deps.sh --cycles` | `scripts/analyze-deps.sh --cycles` |## Script I/O Protocol- **stdout**: JSON output for agent consumption- **stderr**: Human-readable progress/status messages## Guidelines- When refactoring the Go Host, prioritize **Performance** and **Safety**.- When writing Plugins, use **Lua 5.1** syntax.- **Safety**: Never expose unsafe OS primitives to Lua without a sidebar allowlist (like `switchai.exec`).---> Converted and distributed by [TomeVault](https://tomevault.io/claim/traylinx) — claim your Tome and manage your conversions.

Frequently asked questions