Stello Agent Creation
stello-agent/stello
StelloAgent 创建配置教程。完整说明 createStelloAgent 的每个配置项，包含 sessionDefaults、storage、tools、skills、forkProfiles、session 层接入、orchestration 等。
Stello 仓库总览入口。快速理解各包的关系、推荐入口、编排模型、单一 Session 模型. An agent skill from stello-agent/stello.
Apache-2.0Auto-check passed
Install Stello Usage
$ npx skills add stello-agent/stello --skill stello-usage -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install stello-agent/stello stello-usage --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/stello-agent/stello.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/stello-usage .claude/skills/stello-usage && rm -rf skills-srcUse ~/.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/
Install the "stello-usage" agent skill from https://github.com/stello-agent/stello/tree/main/.agents/skills/stello-usage into .claude/skills/stello-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "stello-usage", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/stello-agent/stello/tree/main/.agents/skills/stello-usageType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add stello-agent/stello --skill stello-usage -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install stello-agent/stello stello-usage --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/stello-agent/stello.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/stello-usage .agents/skills/stello-usage && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "stello-usage" agent skill from https://github.com/stello-agent/stello/tree/main/.agents/skills/stello-usage into .agents/skills/stello-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "stello-usage", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add stello-agent/stello --skill stello-usage -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install stello-agent/stello stello-usage --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/stello-agent/stello.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/stello-usage .cursor/skills/stello-usage && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "stello-usage" agent skill from https://github.com/stello-agent/stello/tree/main/.agents/skills/stello-usage into .cursor/skills/stello-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "stello-usage", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/stello-agent/stello.git --path .agents/skills/stello-usage--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add stello-agent/stello --skill stello-usage -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install stello-agent/stello stello-usage --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/stello-agent/stello.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/stello-usage .gemini/skills/stello-usage && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "stello-usage" agent skill from https://github.com/stello-agent/stello/tree/main/.agents/skills/stello-usage into .gemini/skills/stello-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "stello-usage", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install stello-agent/stello stello-usageInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add stello-agent/stello --skill stello-usage -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/stello-agent/stello.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/stello-usage .github/skills/stello-usage && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "stello-usage" agent skill from https://github.com/stello-agent/stello/tree/main/.agents/skills/stello-usage into .github/skills/stello-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "stello-usage", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add stello-agent/stello --skill stello-usage -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install stello-agent/stello stello-usage --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/stello-agent/stello.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/stello-usage .opencode/skills/stello-usage && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "stello-usage" agent skill from https://github.com/stello-agent/stello/tree/main/.agents/skills/stello-usage into .opencode/skills/stello-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "stello-usage", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
stello-usage- GitHub stars
- 112
- Token cost
- ~547 tokens
- SKILL.md length
- 144 words
- Files
- 1
- Skills in repo
- 13
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Stello 仓库总览入口。快速理解各包的关系、推荐入口、编排模型、单一 Session 模型. An agent skill from stello-agent/stello.
- SKILL.md covers 包结构, 推荐入口, 单一 Session 模型 and 编排模型, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Stello Usage is an agent skill from stello-agent/stello. Stello 仓库总览入口。快速理解各包的关系、推荐入口、编排模型、单一 Session 模型。
Its SKILL.md is about 550 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
- “/stello-usage”
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
Stello Usage loads about 547 tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 144 words of instructions outside code blocks.
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). 144 words, ~547 tokens.
Download SKILL.mdSave it as
.claude/skills/stello-usage/SKILL.md (or your agent's skills folder).- name
- stello-usage
- description
- Stello 仓库总览入口。快速理解各包的关系、推荐入口、编排模型、单一 Session 模型。
Stello 使用总览
包结构
@stello-ai/session— 单个 Session 原语层（send / stream / consolidate）@stello-ai/core— 编排层（StelloAgent / SessionOrchestrator / Engine / SessionTree 拓扑）@stello-ai/server— 服务化适配层（PG 持久化 + REST/WS + 多租户 Space）@stello-ai/visualizer— 可视化层（星空图）
推荐入口
createStelloAgent(config) 是 @stello-ai/core 的唯一推荐入口。
开发者不需要手动装配 SessionOrchestrator、DefaultEngineFactory、DefaultEngineRuntimeManager——由 StelloAgent 构造时自动组装。
Server 层承接 StelloAgent，不重写编排逻辑。
单一 Session 模型
Stello 内部只有一种 Session。对话的起点是一个 parentId === null 的 root session，通过 agent.createSession() 创建（不传 parentId）；后续分支用 agent.forkSession() 创建子 session（parentId 指向父节点）。
拓扑允许多 root —— 同一个 agent 下可以并存多棵互相独立的对话树（森林）。所有 Session 共用同一套上下文组装规则、同一套 SessionStorage 接口；root 不具备任何特殊运行时行为，差异只体现在 TopologyNode.parentId 上。
跨 Session 的"全局意识层"由应用层承载——读取所有 Session 的 digest（memory + insight），用任意 LLM 反思后通过 agent.putInsight(targetId, content) 定向回写。详见 skill session-usage。
编排模型
StelloAgent（门面 + orchestrator-facing 数据 SDK）
→ SessionOrchestrator（多 Session 协调）
→ EngineRuntimeManager（runtime 生命周期）
→ DefaultEngineFactory（内联 consolidation 触发逻辑，闭包注入 hooks）
→ StelloEngine（单 Session 对话循环 + fire-and-forget hooks）
→ SessionRuntime（@stello-ai/session 适配）一句话：Session 做单次调用，Engine 做对话循环，Factory 内联触发逻辑，Orchestrator 协调多 Session，Agent 是统一入口。
并发语义：同 sessionId 内串行，不同 sessionId 之间并行。
Session 接入
@stello-ai/core 通过 StelloAgentSessionConfig 接入 @stello-ai/session：
sessionLoader(sessionId)— 按 ID 解析真实 Session 实例（所有 Session 共用同一个 loader）serializeSendResult/toolCallParser— 序列化与工具解析
外加顶层 StelloAgentConfig.storage 用于 data-IO SDK（listSessionDigests / putMemory / putInsight 等）。应用层需保证 sessions（拓扑）与 storage（内容）指向同一份持久化后端。
与 server / sdk 的关系
core= 库server= 服务化适配层sdk= 对 server API 的薄客户端封装（未来）
推荐继续阅读
Skills：stello-agent-creation / stello-agent-usage / orchestrator-usage / engine-design / scheduler-design / session-usage / fork-design / storage-design / server-design
© 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/stello-usage of stello-agent/stello.
Open the folder on GitHubat commit 3bc9493
Compare with similar skills
Stello Usage 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Stello Usage this skillstello-agent/stello | 112 | — | ~547 | Automated safety check: Pass | Apache-2.0 | |
| Stello Agent Creationstello-agent/stello | 112 | — | ~3.2k | Automated safety check: Pass | Apache-2.0 | |
| Stello Agent Usagestello-agent/stello | 112 | — | ~2.7k | Automated safety check: Pass | Apache-2.0 | |
| Server Package Planstello-agent/stello | 112 | — | ~195 | Automated safety check: Pass | Apache-2.0 | |
| Server Storagestello-agent/stello | 112 | — | ~470 | Automated safety check: Pass | Apache-2.0 | |
| LLM Call Sitesstello-agent/stello | 112 | — | ~793 | Automated safety check: Pass | Apache-2.0 |
Similar skills
Stello Agent Usage
stello-agent/stello
StelloAgent 运行时使用教程。覆盖 Session 生命周期、createSession、turn/stream 对话、fork 配置合成链、orchestrator-facing 数据 SDK、runtime 管理、热更新等运行时 API。
Server Package Plan
stello-agent/stello
@stello-ai/server 的职责边界和设计原则。Server 只做服务化适配，不重写编排逻辑. An agent skill from stello-agent/stello.
Server Storage
stello-agent/stello
@stello-ai/server 的 PG 持久化层设计决策和实现模式。触发条件：修改或引用 server 存储层. An agent skill from stello-agent/stello.
LLM Call Sites
stello-agent/stello
Stello 框架内所有 LLM 调用位置的消息结构速查。覆盖 Session 对话、compress、consolidate；应用层 reflection 调用由 orchestrator 自行决定。
Fork Design
stello-agent/stello
Fork 机制完整说明。覆盖 ForkProfile 与 EngineForkOptions 的字段对齐、四层 fallback 合成链（sessionDefaults → parent → profile → forkOptions）、systemPrompt 合成三种模式、skills 三态语义、持久化边界（SerializableSessionConfig 只固化…
More from stello-agent/stello
All 13 skills in this repoSession Usage
stello-agent/stello
Session 对话单元的设计理念、上下文组装规则、memory / insight 槽位语义、单一 Session 模型与跨 Session 通信模型。
Storage Design
stello-agent/stello
存储接口的设计原则、SessionMeta 与 TopologyNode 解耦、上下文槽位、单一 SessionStorage 接口。触发条件：理解或实现 SessionStorage / SessionTree。
Scheduler Design
stello-agent/stello
Consolidation 触发机制：自动触发通过 Factory 配置内联，手动触发通过 StelloAgent API；全局 reflection 由应用层在 SDK 之上自行实现。
Server Design
stello-agent/stello
Server 层设计：传输层架构决策、StelloAgent 映射原则、连接态管理模式。存储层见 server-storage，Engine 细节见 engine-design。
Engine Design
stello-agent/stello
Engine 职责定义：per-session-round 生命周期管理器。驱动 tool call 循环，管理单个 Session 的多轮对话。不感知树结构，不感知调度。
Orchestrator Usage
stello-agent/stello
Orchestrator 层定位、设计决策、与上下层的关系。开发者面向的 opinionated 库，Server 基于它构建。
Questions about Stello Usage
What does Stello Usage do?
Stello 仓库总览入口。快速理解各包的关系、推荐入口、编排模型、单一 Session 模型. An agent skill from stello-agent/stello. Stello Usage is an agent skill from stello-agent/stello.
How do I install Stello Usage in Claude Code?
Run `npx skills add stello-agent/stello --skill stello-usage -a claude-code`. Or copy the skill folder (.agents/skills/stello-usage in stello-agent/stello) into .claude/skills/stello-usage in your project. Claude Code loads it when a task matches its description.
How do I install Stello Usage in Codex?
Run `npx skills add stello-agent/stello --skill stello-usage -a codex`. Or copy the skill folder (.agents/skills/stello-usage in stello-agent/stello) into .agents/skills/stello-usage in your project. Codex loads it when a task matches its description.
Can I use Stello Usage 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 stello-usage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/stello-usage, .gemini/skills/stello-usage, .github/skills/stello-usage and .opencode/skills/stello-usage in your project.
What does Stello Usage need to run?
SKILL.md names no scripts, command-line tools or credentials: Stello Usage is instructions for the agent only.
Does Stello Usage 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 Stello Usage 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 Stello Usage use?
Stello Usage 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 Stello Usage use?
About 547 tokens (SKILL.md is roughly 2.2k 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 Stello Usage?
Skills that share tags, products or a category with Stello Usage: Stello Agent Creation (stello-agent/stello, 112 stars), Stello Agent Usage (stello-agent/stello, 112 stars), Server Package Plan (stello-agent/stello, 112 stars) and Server Storage (stello-agent/stello, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Stello Usage?
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.