preset-skill-op-activation-session-refresh

Documents how saved presets become running defaults and how /refresh switches agent sessions.

692|60|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Lingtai-AI/lingtai --skill preset-skill-op-activation-session-refresh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preset-skill-op-activation-session-refresh
Source: https://github.com/Lingtai-AI/lingtai/tree/main/tui/internal/preset/skills/lingtai-preset-skill/reference/operations/activation-session-refresh
Command: npx skills add https://github.com/Lingtai-AI/lingtai --skill preset-skill-op-activation-session-refresh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It clarifies the confusing lifecycle of agent presets in the LingTai TUI: when a saved preset actually takes effect, how the setup wizard's default/allowed selection propagates across the agent network, and why editing a preset does not change an already-running session.

Core Features & Use Cases

  • Activation semantics: Explains that the agent-preset page lists only saved presets, that the default must always be a member of the allowed list, and that re-running /setup preserves existing configuration rather than resetting it.
  • Network propagation: Describes how /setup pushes the chosen {default, allowed} policy best-effort to every agent in the project.
  • /refresh behavior: Details the three forms (/refresh all, /refresh <preset>, bare /refresh) and the key rule that saving a preset alone never switches a running session.
  • Use Case: A developer edits and saves a preset, expects the running agent to change, and nothing happens; this reference explains that an explicit /refresh, relaunch, or new service construction is required.

Quick Start

Ask the agent to explain why a newly saved preset is not affecting the running session and what /refresh command applies it.

Frequently Asked Questions about preset-skill-op-activation-session-refresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why doesn't my saved preset change the running agent session?

Saving a preset only updates stored configuration; it never switches a live session. The new preset takes effect on the next explicit /refresh [preset], agent relaunch, or new service construction.

What does the /refresh command do in the LingTai TUI?

/refresh has three forms: /refresh all hard-refreshes every non-human agent at its current preset, /refresh <preset> switches the target agent to a preset resolved against its allowed list, and bare /refresh hard-refreshes at the current preset.

Does re-running /setup reset my preset configuration?

No. Re-running /setup hydrates the allowed list and default from the existing manifest.preset.{default,allowed}, so only what you explicitly change is modified. Path comparison is normalized so ~/... and absolute paths match.

Can the default preset be outside the allowed list?

No. The schema invariant requires the default to be a member of allowed, and the setup wizard forces the default row into presetAllowed, writing the default first followed by the other checked rows.

Does /setup apply preset policy to other agents in the project?

Yes. The wizard's chosen {default, allowed} surface is propagated best-effort to every other agent in the project network. Failures are not surfaced as errors because the primary agent's save already succeeded.