Back to list
turbobeest

websocket-expert

by turbobeest

structured vibe coding tool driven by custom agents - highly recommend using only with claude code max subscription

2🍴 0📅 Jan 8, 2026

SKILL.md


skill_name: agent-selector activation_code: AGENT_SELECTOR_V1 version: 1.0.0 phase: 5.5 prerequisites:

  • PRD with Section 8 (Technical Architecture)
  • PHASE5_COMPLETE signal outputs:
  • .claude/agent-config.json
  • .claude/agents/ directory description: | Selects and configures agents from the agents repo based on PRD tech stack. Runs after task decomposition, before specification generation.

Agent Selector Skill

When to Use

  • After Phase 5 (Task Decomposition) completes successfully
  • User requests agent configuration: "select agents for my project", "configure agents"
  • PRD with Technical Architecture (Section 8) is available for tech stack analysis
  • Starting a new project that needs agent pool customization
  • User invokes: "/select-agents", "which agents should I use?"
  • Reconfiguring agents mid-project when tech stack changes

Activation

Triggered after Phase 5 (Task Decomposition) completes:

[ACTIVATE:AGENT_SELECTOR_V1]

Purpose

Analyze PRD to determine optimal agent selection for the project.

Execution Flow

Step 1: Extract Tech Stack from PRD

Read PRD Section 8 (Technical Architecture) and identify:

languages:
  - primary: TypeScript
  - secondary: Python

frameworks:
  - frontend: Next.js, React
  - backend: FastAPI

databases:
  - primary: PostgreSQL
  - graph: Neo4j

infrastructure:
  - cloud: AWS
  - containers: Docker, Kubernetes
  - iac: Terraform

special_domains:
  - ml: false
  - blockchain: false
  - gaming: false
  - spatial: false

Step 2: Map to Agents

Use the agent mapping table:

TechAgent
TypeScripttypescript-pro
Pythonpython-pro
Next.jsnextjs-expert
Reactreactjs-expert
FastAPIpython-pro (covers FastAPI)
PostgreSQLsql-pro
Neo4jneo4j-expert
AWSaws-expert
Dockerdocker-expert
Kuberneteskubernetes-expert
Terraformterraform-expert

Step 3: Determine Security Level

From PRD Section 11 (Security Requirements):

LevelAdditional Agents
Standardsecurity-auditor
Highsecurity-auditor, penetration-tester
Compliancesecurity-auditor, compliance-checker
FinancialAll security + compliance-checker

Step 4: Check Scale Requirements

From PRD Section 6 (Non-Functional Requirements):

RequirementAdditional Agents
High Performanceperformance-engineer, cache-expert
Large Datadata-engineer, database-optimizer
Real-timeperformance-engineer

Step 5: Generate agent-config.json

{
  "version": "1.0.0",
  "source": {
    "local": "agents/",
    "upstream_repo": "https://github.com/turbobeest/agents",
    "note": "Agents bundled locally"
  },
  "agents": {
    "core": {
      "include": [
        "orchestration-intelligence/core-orchestration/orchestrator",
        "orchestration-intelligence/planning-assignment/planning-agent",
        "orchestration-intelligence/quality-control/validation-depth-controller"
      ]
    },
    "auditors": {
      "include": [
        "infrastructure-security/security-compliance/security-auditor",
        "development-architecture/system-architecture/architect-reviewer"
      ]
    },
    "tech-stack": {
      "languages": ["typescript-pro", "python-pro"],
      "frameworks": ["nextjs-expert", "reactjs-expert"],
      "databases": ["sql-pro", "neo4j-expert"],
      "infrastructure": ["aws-expert", "docker-expert", "kubernetes-expert"]
    }
  },
  "phase-gates": {
    "4": ["security-auditor"],
    "8": ["architect-reviewer", "security-auditor"],
    "11": ["security-auditor"]
  }
}

Step 6: Present to User

╔═══════════════════════════════════════════════════════════════════════╗
║                         AGENT SELECTION                                ║
╠═══════════════════════════════════════════════════════════════════════╣
║                                                                        ║
║  Based on your PRD, I recommend the following agents:                 ║
║                                                                        ║
║  CORE (always included):                                              ║
║    • orchestrator         - Pipeline coordination                      ║
║    • planning-agent       - Task planning                              ║
║    • validation-controller - Quality gates                             ║
║                                                                        ║
║  LANGUAGES:                                                            ║
║    • typescript-pro       - TypeScript expertise                       ║
║    • python-pro           - Python/FastAPI expertise                   ║
║                                                                        ║
║  FRAMEWORKS:                                                           ║
║    • nextjs-expert        - Next.js patterns                           ║
║    • reactjs-expert       - React best practices                       ║
║                                                                        ║
║  DATABASES:                                                            ║
║    • sql-pro              - PostgreSQL optimization                    ║
║    • neo4j-expert         - Graph database patterns                    ║
║                                                                        ║
║  INFRASTRUCTURE:                                                       ║
║    • aws-expert           - AWS services                               ║
║    • docker-expert        - Containerization                           ║
║    • kubernetes-expert    - K8s deployment                             ║
║                                                                        ║
║  AUDITORS (phase gates):                                               ║
║    • security-auditor     - Required: Phase 4, 8, 11                   ║
║    • architect-reviewer   - Required: Phase 8                          ║
║                                                                        ║
╠═══════════════════════════════════════════════════════════════════════╣
║  [A] Accept  [C] Customize  [S] Skip agents                           ║
╚═══════════════════════════════════════════════════════════════════════╝

Step 7: Sync Agents

On acceptance (agents are bundled locally in agents/):

./scripts/pull-agents.sh --config .claude/agent-config.json

Step 8: Emit Signal

[SIGNAL:AGENTS_CONFIGURED]
[ACTIVATE:SPEC_GEN_V1]

Agent Invention

If during any phase, specialized expertise is needed:

  1. Detect Gap: Skill recognizes missing expertise
  2. Propose Agent: Generate agent definition
---
name: websocket-expert
domain: realtime
role: expert
model: sonnet
description: Real-time WebSocket communication specialist.
tools:
  - Read
  - Write
  - Edit
  - Bash
---

You are an expert in WebSocket and real-time communication...
  1. Save: Write to .claude/agents/custom/websocket-expert.md
  2. Register: Update agent-config.json
  3. Offer Contribution:
New agent created: websocket-expert

Would you like to contribute this agent to the upstream community repo?
[Y] Yes - create PR to turbobeest/agents (upstream)
[N] No - keep local only

Completion

Outputs:

  • .claude/agent-config.json — Configuration
  • .claude/agents/ — Downloaded agents
  • .claude/.signals/AGENTS_CONFIGURED.json — Signal

Output Files

FilePurpose
.claude/agent-config.jsonComplete agent configuration for the project
.claude/agents/Directory containing synced agent definitions
.claude/.signals/AGENTS_CONFIGURED.jsonSignal file indicating successful configuration
.claude/agents/custom/Any custom agents created for gaps in coverage

Signals Emitted

SignalWhen
AGENT_SELECTION_STARTEDTech stack analysis has begun
AGENT_SELECTION_PRESENTEDRecommended agents shown to user for approval
AGENTS_CONFIGUREDUser accepted selection and agents are synced
AGENT_GAP_DETECTEDMissing expertise identified, may trigger agent-inventor

Next phase: Specification (Phase 6)

Score

Total Score

70/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon