Agent skill

Scheduler Design

by stello-agent in stello-agent/stello

Consolidation 触发机制:自动触发通过 Factory 配置内联,手动触发通过 StelloAgent API;全局 reflection 由应用层在 SDK 之上自行实现。

Apache-2.0Auto-check passed

Install Scheduler Design

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

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

GitHub CLI
$ gh skill install stello-agent/stello scheduler-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/scheduler-design .claude/skills/scheduler-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
scheduler-design
GitHub stars
112
Token cost
~349 tokens
SKILL.md length
72 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Consolidation 触发机制:自动触发通过 Factory 配置内联,手动触发通过 StelloAgent API;全局 reflection 由应用层在 SDK 之上自行实现。

  • Works in 2 steps: 自动触发:consolidateEveryNTurns 配置项,由… → 手动触发:agent.consolidateSession(sessionId)
  • Tasks that involve Scheduled and recurring tasks
  • SKILL.md covers 概述, 自动 Consolidation, 手动触发 and 应用层 Reflection 循环, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Scheduler Design is an agent skill from stello-agent/stello. Consolidation 触发机制:自动触发通过 Factory 配置内联,手动触发通过 StelloAgent API;全局 reflection 由应用层在 SDK 之上自行实现。

Its SKILL.md is about 350 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.

When your agent uses it

  • Tasks that involve Scheduled and recurring tasks

Example prompts

  • “/scheduler-design”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 自动触发:consolidateEveryNTurns 配置项,由 Factory 内联处理
  2. 手动触发:agent.consolidateSession(sessionId)

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 (its code samples are typescript).

    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

Scheduler Design loads about 349 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 72 words of instructions outside code blocks.

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

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). 72 words, ~349 tokens.

Download SKILL.mdSave it as .claude/skills/scheduler-design/SKILL.md (or your agent's skills folder).
name
scheduler-design
description
Consolidation 触发机制:自动触发通过 Factory 配置内联,手动触发通过 StelloAgent API;全局 reflection 由应用层在 SDK 之上自行实现。

Consolidation 触发机制

概述

Consolidation 的触发机制有两条路径:

  1. 自动触发:consolidateEveryNTurns 配置项,由 Factory 内联处理
  2. 手动触发:agent.consolidateSession(sessionId)

跨 Session 的 reflection 由应用层在 agent.listSessionDigests / agent.putInsight 之上自行实现,详见 skill session-usage。


自动 Consolidation

在 orchestration 配置中设置 consolidateEveryNTurns,每 N 轮对话后自动触发 consolidation(fire-and-forget):

typescript
orchestration: {
  consolidateEveryNTurns: 5,
}

这是框架提供的唯一自动触发策略。逻辑内联在 Factory 的 hook 中,无独立调度器组件。


手动触发

typescript
await agent.consolidateSession(sessionId)

应用层可在任意时机调用,例如 session 结束时、定时任务、用户操作后。


应用层 Reflection 循环

typescript
async function reflect() {
  const digests = await agent.listSessionDigests({ status: 'active' })
  // 调任意 LLM、用任意 schema 解析 ...
  for (const [id, content] of Object.entries(insightsByTarget)) {
    await agent.putInsight(id, content)
  }
}

可在 hooks.onRoundEnd / hooks.onSessionFork 内 fire-and-forget 触发,或绑定到外部 cron / 用户操作。框架不假设调用频率与策略——这部分被有意外推到应用层。


设计决策

调度被有意压到最小:

  • 自动调度只保留"每 N 轮 consolidate"——这是高频被用的唯一策略,其他策略都被应用层覆盖
  • 全局 reflection 的频率 / prompt / schema / LLM tier 选择强烈与应用业务耦合,框架不假设
  • reflection 由应用层在 listSessionDigests / putInsight 之上自行实现,框架不持有跨 Session 状态

© 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/scheduler-design of stello-agent/stello.

Open the folder on GitHubat commit 3bc9493

Compare with similar skills

Scheduler 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.

Scheduler Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scheduler Design this skillstello-agent/stello112—~349Automated safety check: PassApache-2.0
SkillOpt Sleep Cyclemicrosoft/SkillOpt18k—~2.3kAutomated safety check: PassMIT
ScheduleTinyAGI/tinyagi3.6k—~1.4kAutomated safety check: PassMIT
SkillOpt-Sleep Self-Improvement Cyclemicrosoft/SkillOpt18k—~2.3kAutomated safety check: PassMIT
Supabasecurvenote/curvenote1705 repos~2.2kAutomated safety check: PassCustom licence
OpenObserve PR Briefopenobserve/openobserve22k—~1.8kAutomated safety check: PassAGPL-3.0

Similar skills

  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Schedule

    TinyAGI/tinyagi

    Create, list, and delete scheduled tasks (recurring or one-time) that send messages to agents.

    3.6k GitHub stars~1.4k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check passed
  • Official

    Runs a nightly or on-demand sleep cycle for a local Codex agent: review past sessions, replay recurring tasks and stage validated skill and memory edits for adoption.

    18k GitHub stars~2.3k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Supabase

    curvenote/curvenote

    A skill your agent uses when doing ANY task involving Supabase.

    170 GitHub starsUsed in 5 repos~2.2k tokens
    Backend & APIsAuto-check passed
  • OpenObserve PR Brief

    openobserve/openobserve

    Produces a read-only morning brief of your open pull requests across the openobserve GitHub org, with a next step for each and a reminder for idle ones.

    22k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Send User Message

    TinyAGI/tinyagi

    Send a proactive message to a paired user via their channel (Discord, Telegram, or WhatsApp).

    3.6k GitHub stars~829 tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check passed

More from stello-agent/stello

All 12 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 Scheduler Design

What does Scheduler Design do?

Consolidation 触发机制:自动触发通过 Factory 配置内联,手动触发通过 StelloAgent API;全局 reflection 由应用层在 SDK 之上自行实现。. Scheduler Design is an agent skill from stello-agent/stello.

When should I use Scheduler Design?

Scheduler Design fits situations like: tasks that involve Scheduled and recurring tasks.

How do I install Scheduler Design in Claude Code?

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

How do I install Scheduler Design in Codex?

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

Can I use Scheduler 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 scheduler-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/scheduler-design, .gemini/skills/scheduler-design, .github/skills/scheduler-design and .opencode/skills/scheduler-design in your project.

What does Scheduler Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Scheduler Design is instructions for the agent only.

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

Scheduler 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 Scheduler Design use?

About 349 tokens (SKILL.md is roughly 1.4k 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 Scheduler Design?

Skills that share tags, products or a category with Scheduler Design: SkillOpt Sleep Cycle (microsoft/SkillOpt, 18k stars), Schedule (TinyAGI/tinyagi, 3.6k stars), SkillOpt-Sleep Self-Improvement Cycle (microsoft/SkillOpt, 18k stars) and Supabase (curvenote/curvenote, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scheduler Design?

stello-agent (a GitHub organization) maintains it in stello-agent/stello, which has 112 GitHub stars. The repository holds 12 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.