How do I install the Local Services skill?

Run npx skillmds@latest add tgoai/local-services 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 Local Services 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 Local Services?

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 Local Services free to use?

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

Who published Local Services?

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

Local Services by tgoai — Agent Skill

Name: Local Services
Author: tgoai

Local Services

Start, stop, and check local development services with intelligent minimum-set management. Trigger when services need to be running for functional verification or manual testing — starts the minimum required set (infrastructure + tgo-api + tgo-ai) by default, with optional extras auto-detected from git diff or specified manually. Includes status checking and graceful shutdown.

tgoai d926ed1 4 files · 9.1 KB Updated Sep 17, 2026

File contents

local-services

Purpose

Start, stop, and check local development services. Knows the minimum required set and can auto-detect additional services needed based on code changes.

Trigger

Before running functional verification (services must be running)
When starting a development session
When agent needs to test API changes at runtime

Minimum Services

The core platform requires only 3 things to be functional:

Infrastructure — PostgreSQL, Redis, WuKongIM (make infra-up)
tgo-api — Core API gateway (port 8000)
tgo-ai — LLM / Agent runtime (port 8081)

All other services are optional and can be added based on what you're working on.

Service Map

Service	Make target	Port	When needed
Infrastructure	`make infra-up`	5432/6379/5001	Always
tgo-api	`make dev-api`	8000	Always
tgo-ai	`make dev-ai`	8081	Always
tgo-rag	`make dev-rag`	18082	Knowledge base / RAG changes
tgo-platform	`make dev-platform`	8003	Channel integration changes
tgo-workflow	`make dev-workflow`	8004	Workflow engine changes
tgo-plugin-runtime	`make dev-plugin`	8090	Plugin / MCP tool changes
tgo-device-control	`make dev-device`	8085	Device management changes
tgo-web	`make dev-web`	5173	Admin frontend changes
tgo-widget-js	`make dev-widget`	5174	Visitor widget changes
RAG worker	`make dev-rag-worker`	—	Document processing tasks
Workflow worker	`make dev-wf-worker`	—	Workflow execution tasks

Usage

# Start minimum services (infra + api + ai)
bash .skills/local-services/scripts/start.sh

# Start minimum + specific extras
bash .skills/local-services/scripts/start.sh rag web

# Start minimum + auto-detect extras from git diff
bash .skills/local-services/scripts/start.sh --auto

# Start everything
bash .skills/local-services/scripts/start.sh --all

# Check what's running
bash .skills/local-services/scripts/status.sh

# Stop all services
bash .skills/local-services/scripts/stop.sh

---name: local-servicesdescription: Start, stop, and check local development services with intelligent minimum-set management. Trigger when services need to be running for functional verification or manual testing — starts the minimum required set (infrastructure + tgo-api + tgo-ai) by default, with optional extras auto-detected from git diff or specified manually. Includes status checking and graceful shutdown.---# local-services## PurposeStart, stop, and check local development services. Knows the minimum required set and can auto-detect additional services needed based on code changes.## Trigger- Before running functional verification (services must be running)- When starting a development session- When agent needs to test API changes at runtime## Minimum ServicesThe core platform requires only 3 things to be functional:1. **Infrastructure** — PostgreSQL, Redis, WuKongIM (`make infra-up`)2. **tgo-api** — Core API gateway (port 8000)3. **tgo-ai** — LLM / Agent runtime (port 8081)All other services are optional and can be added based on what you're working on.## Service Map| Service | Make target | Port | When needed ||---------|------------|------|-------------|| Infrastructure | `make infra-up` | 5432/6379/5001 | Always || tgo-api | `make dev-api` | 8000 | Always || tgo-ai | `make dev-ai` | 8081 | Always || tgo-rag | `make dev-rag` | 18082 | Knowledge base / RAG changes || tgo-platform | `make dev-platform` | 8003 | Channel integration changes || tgo-workflow | `make dev-workflow` | 8004 | Workflow engine changes || tgo-plugin-runtime | `make dev-plugin` | 8090 | Plugin / MCP tool changes || tgo-device-control | `make dev-device` | 8085 | Device management changes || tgo-web | `make dev-web` | 5173 | Admin frontend changes || tgo-widget-js | `make dev-widget` | 5174 | Visitor widget changes || RAG worker | `make dev-rag-worker` | — | Document processing tasks || Workflow worker | `make dev-wf-worker` | — | Workflow execution tasks |## Usage```bash# Start minimum services (infra + api + ai)bash .skills/local-services/scripts/start.sh# Start minimum + specific extrasbash .skills/local-services/scripts/start.sh rag web# Start minimum + auto-detect extras from git diffbash .skills/local-services/scripts/start.sh --auto# Start everythingbash .skills/local-services/scripts/start.sh --all# Check what's runningbash .skills/local-services/scripts/status.sh# Stop all servicesbash .skills/local-services/scripts/stop.sh```

Frequently asked questions