Agent skill

Server Design

by stello-agent in stello-agent/stello

Server 层设计:传输层架构决策、StelloAgent 映射原则、连接态管理模式。存储层见 server-storage,Engine 细节见 engine-design。

Apache-2.0Auto-check passed

Install Server Design

skills CLI
$ npx skills add stello-agent/stello --skill server-design -a claude-code

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

GitHub CLI
$ gh skill install stello-agent/stello server-design --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/stello-agent/stello.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/server-design .claude/skills/server-design && 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
server-design
GitHub stars
112
Token cost
~397 tokens
SKILL.md length
133 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

Server 层设计:传输层架构决策、StelloAgent 映射原则、连接态管理模式。存储层见 server-storage,Engine 细节见 engine-design。

  • SKILL.md covers 架构分层, 设计决策, 连接态管理 and AgentPool 默认 fn 注入, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Server Design is an agent skill from stello-agent/stello. Server 层设计:传输层架构决策、StelloAgent 映射原则、连接态管理模式。存储层见 server-storage,Engine 细节见 engine-design。

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

The repository describes itself as: Conversations aren't linear — why should AI chats be? The first open-source conversation topology engine. Auto-branching session trees, inherited memory, star-map visualization… The licence is Apache-2.0.

Example prompts

  • “/server-design”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 3bc9493. 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.

    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

Server Design loads about 397 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 133 words of instructions outside code blocks.

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

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 stello-agent/stello at commit 3bc9493, republished under its Apache-2.0 licence (© stello-agent). 133 words, ~397 tokens.

Download SKILL.mdSave it as .claude/skills/server-design/SKILL.md (or your agent's skills folder).
name
server-design
description
Server 层设计:传输层架构决策、StelloAgent 映射原则、连接态管理模式。存储层见 server-storage,Engine 细节见 engine-design。

Server 层(Service Layer)设计

相关 skill:server-storage(PG 持久化)、engine-design(Engine 内部)、orchestrator-usage(StelloAgent API)


架构分层

Transport Layer(Hono REST + ws WebSocket)
  ↓
Space 管理层(SpaceManager · AgentPool)
  ↓
PG Storage Layer(4 个 Storage Adapter)
  ↓
Core(@stello-ai/core — StelloAgent → SessionOrchestrator → Engine)

设计决策

  • WS 用 ws 库 — Hono 内置 WS 面向 edge,不适合 Node.js
  • WS 认证用 header — API key 不暴露在 URL
  • stream 和 message 是独立消息类型 — 客户端显式选择
  • Space 级 WS 连接 — URL 中确定 spaceId,匹配 AgentPool per-space 缓存
  • REST 降级路径 — /turn 端点支持无 WS 的非流式对话
  • 断连只 detach 不 leave — runtime 通过 recyclePolicy 自然回收

连接态管理

ConnectionManager(纯内存,不持久化):

connectionId → { userId, spaceId, sessionId | null }
  • WS upgrade 时 bind(connId, userId, spaceId)
  • session.enter 时 attach
  • session.leave / socket close 时 detach
  • socket close 时 unbind

AgentPool 默认 fn 注入

AgentPool 支持内置默认 consolidateFn:

  • AgentPoolOptions.llm 提供最小 LLM 调用接口
  • Space 表存 consolidatePrompt
  • 如果 buildConfig 未提供显式 fn,且 Space 有 prompt 且 llm 可用 → 自动注入默认实现
  • buildConfig 提供的显式 fn 始终优先

跨 Session 的 reflection / 全局综合不由 Server 框架承担——服务端只暴露 StelloAgent 的 orchestrator-facing 数据 SDK(listSessionDigests / putInsight 等),应用层基于这些原语自行实现。


createStelloServer 入口

createStelloServer(options) 返回 StelloServer,内部用 @hono/node-server 的 serve() 创建 HTTP server,再附着 ws.WebSocketServer({ noServer: true })。

© stello-agent, Apache-2.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 .agents/skills/server-design of stello-agent/stello.

Open the folder on GitHubat commit 3bc9493

Compare with similar skills

Server Design 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.

Server Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Server Design this skillstello-agent/stello112—~397Automated safety check: PassApache-2.0
Object Storagesickn33/agentic-awesome-skills47k2 repos~2.6kAutomated safety check: PassMIT
Neon Object Storagesickn33/agentic-awesome-skills47k1 repos~2.9kAutomated safety check: NotesApache-2.0
Web Storagethedaviddias/Front-End-Checklist74k—~506Automated safety check: PassMIT
Token Storage Securitythedaviddias/Front-End-Checklist74k—~604Automated safety check: PassMIT
Django Storages for S3Jeffallan/claude-skills12k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Object Storage

    sickn33/agentic-awesome-skills

    Configure object storage with S3, GCS, and MinIO. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~2.6k tokens
    Backend & APIsAuto-check passed
  • Neon Object Storage

    sickn33/agentic-awesome-skills

    S3-compatible object storage that branches with your Neon project, so files and the database stay in sync across every branch.

    47k GitHub starsUsed in 1 repo~2.9k tokens
    Backend & APIsAuto-check: notes
  • Web Storage

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing scripts, client components, bundles, or runtime behavior related to Use Web Storage API safely.

    74k GitHub stars~506 tokensUpdated yesterday
    Auto-check passed
  • Token Storage Security

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing authentication implementation, setting up a new auth system, or evaluating whether the current token storage approach exposes the application to XSS-based…

    74k GitHub stars~604 tokensUpdated yesterday
    SecurityAuto-check passed
  • Django Storages for S3

    Jeffallan/claude-skills

    Sets up Django 4.2+ to keep static and media files on AWS S3 through django-storages, with public and private backends, presigned URLs and CloudFront.

    12k GitHub stars~1.9k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed
  • Gke Storage

    google/skills

    Official

    Manages GKE storage, including PVCs, PersistentVolumes, and Filestore.

    21k GitHub stars~1.8k tokensUpdated yesterday
    DatabasesAuto-check passed

More from stello-agent/stello

All 13 skills in this repo
  • Fork Design

    stello-agent/stello

    Fork 机制完整说明。覆盖 ForkProfile 与 EngineForkOptions 的字段对齐、四层 fallback 合成链(sessionDefaults → parent → profile → forkOptions)、systemPrompt 合成三种模式、skills 三态语义、持久化边界(SerializableSessionConfig 只固化…

    112 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • LLM Call Sites

    stello-agent/stello

    Stello 框架内所有 LLM 调用位置的消息结构速查。覆盖 Session 对话、compress、consolidate;应用层 reflection 调用由 orchestrator 自行决定。

    112 GitHub stars~793 tokensUpdated 2 mo ago
    Auto-check passed
  • Session Usage

    stello-agent/stello

    Session 对话单元的设计理念、上下文组装规则、memory / insight 槽位语义、单一 Session 模型与跨 Session 通信模型。

    112 GitHub stars~763 tokensUpdated 2 mo ago
    Auto-check passed
  • Stello Agent Creation

    stello-agent/stello

    StelloAgent 创建配置教程。完整说明 createStelloAgent 的每个配置项,包含 sessionDefaults、storage、tools、skills、forkProfiles、session 层接入、orchestration 等。

    112 GitHub stars~3.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Stello Agent Usage

    stello-agent/stello

    StelloAgent 运行时使用教程。覆盖 Session 生命周期、createSession、turn/stream 对话、fork 配置合成链、orchestrator-facing 数据 SDK、runtime 管理、热更新等运行时 API。

    112 GitHub stars~2.7k tokensUpdated 2 mo ago
    Auto-check passed
  • Stello Usage

    stello-agent/stello

    Stello 仓库总览入口。快速理解各包的关系、推荐入口、编排模型、单一 Session 模型. An agent skill from stello-agent/stello.

    112 GitHub stars~547 tokensUpdated 2 mo ago
    Auto-check passed

Questions about Server Design

What does Server Design do?

Server 层设计:传输层架构决策、StelloAgent 映射原则、连接态管理模式。存储层见 server-storage,Engine 细节见 engine-design。. Server Design is an agent skill from stello-agent/stello.

How do I install Server Design in Claude Code?

Run `npx skills add stello-agent/stello --skill server-design -a claude-code`. Or copy the skill folder (.agents/skills/server-design in stello-agent/stello) into .claude/skills/server-design in your project. Claude Code loads it when a task matches its description.

How do I install Server Design in Codex?

Run `npx skills add stello-agent/stello --skill server-design -a codex`. Or copy the skill folder (.agents/skills/server-design in stello-agent/stello) into .agents/skills/server-design in your project. Codex loads it when a task matches its description.

Can I use Server Design 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 stello-agent/stello --skill server-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/server-design, .gemini/skills/server-design, .github/skills/server-design and .opencode/skills/server-design in your project.

What does Server Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Server Design is instructions for the agent only. Our summary lists: Node.js.

Does Server Design 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 Server Design 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 Server Design use?

Server Design is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Server Design use?

About 397 tokens (SKILL.md is roughly 1.6k 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 Server Design?

Skills that share tags, products or a category with Server Design: Object Storage (sickn33/agentic-awesome-skills, 47k stars), Neon Object Storage (sickn33/agentic-awesome-skills, 47k stars), Web Storage (thedaviddias/Front-End-Checklist, 74k stars) and Token Storage Security (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Server Design?

stello-agent (a GitHub organization) maintains it in stello-agent/stello, which has 112 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on July 24, 2026.

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