Agent Zero AI framework
Add protocol prompt area before history
frdelafdc3aeb44b2
diff --git a/AGENTS.md b/AGENTS.mdindex a3738d8ee..8340f16b9 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -96,7 +96,7 @@ When running in Docker, Agent Zero uses two distinct Python runtimes to isolate```Key Files:-- agent.py: Defines AgentContext and the main Agent class.+- agent.py: Defines AgentContext, LoopData virtual prompt areas (Protocol before history and Extras after history), and the main Agent class.- helpers/plugins.py: Plugin discovery and configuration logic.- webui/js/AlpineStore.js: Store factory for reactive frontend state.- helpers/api.py: Base class for all API endpoints.diff --git a/agent.py b/agent.pyindex 8eef2906b..f8c902da7 100644--- a/agent.py+++ b/agent.py@@ -338,6 +338,8 @@ class LoopData:self.system = []self.user_message: history.Message | None = Noneself.history_output: list[history.OutputMessage] = []+ self.protocol_temporary: OrderedDict[str, history.MessageContent] = OrderedDict()+ self.protocol_persistent: OrderedDict[str, history.MessageContent] = OrderedDict()self.extras_temporary: OrderedDict[str, history.MessageContent] = OrderedDict()self.extras_persistent: OrderedDict[str, history.MessageContent] = OrderedDict()self.last_response = ""@@ -580,24 +582,28 @@ class Agent:# concatenate system promptsystem_text = "\n\n".join(loop_data.system)- # join extras- extras = history.Message( # type: ignore[abstract]- False,- content=self.read_prompt(- "agent.context.extras.md",- extras=dirty_json.stringify(- {**loop_data.extras_persistent, **loop_data.extras_temporary}- ),- ),- ).output()+ # join protocol and extras+ protocol = self._build_context_message(+ "agent.context.protocol.md",+ "protocol",+ {**loop_data.protocol_persistent, **loop_data.protocol_temporary},+ include_empty=False,+ )+ extras = self._build_context_message(+ "agent.context.extras.md",+ "extras",+ {**loop_data.extras_persistent, **loop_data.extras_temporary},+ include_empty=True,+ )+ loop_data.protocol_temporary.clear()loop_data.extras_temporary.clear()- # convert history + extras to LLM format+ # convert protocol + history + extras to LLM formathistory_langchain: list[BaseMessage] = history.output_langchain(- loop_data.history_output + extras+ protocol + loop_data.history_output + extras)- # build full prompt from system prompt, message history and extrS+ # build full prompt from system prompt, protocol, message history and extrasfull_prompt: list[BaseMessage] = [SystemMessage(content=system_text),*history_langchain,@@ -615,6 +621,24 @@ class Agent:return full_prompt+ def _build_context_message(+ self,+ prompt_file: str,+ variable_name: str,+ values: dict[str, history.MessageContent],+ include_empty: bool,+ ) -> list[history.OutputMessage]:+ if not include_empty and not values:+ return []++ return history.Message( # type: ignore[abstract]+ False,+ content=self.read_prompt(+ prompt_file,+ **{variable_name: dirty_json.stringify(values)},+ ),+ ).output()+@extension.extensibleasync def handle_exception(self, location: str, exception: Exception):if exception:@@ -920,9 +944,9 @@ class Agent:model,history_counter,)- call_data["responses_local_input_items"] = (- self._responses_static_prefix_items(model, messages)- + self._responses_input_items_since(model, 0)+ call_data["responses_local_input_items"] = self._responses_prompt_input_items(+ model,+ messages,)await extension.call_extensions_async(@@ -1014,18 +1038,12 @@ class Agent:return ResponsesTransport.input_from_messages(converted)return []- def _responses_static_prefix_items(+ def _responses_prompt_input_items(self, model: Any, messages: list[BaseMessage]) -> list[dict[str, Any]]:- prefix: list[BaseMessage] = []- for message in messages:- if isinstance(message, SystemMessage):- prefix.append(message)- continue- break- if not prefix or not hasattr(model, "_convert_messages"):+ if not hasattr(model, "_convert_messages"):return []- converted = model._convert_messages(prefix)+ converted = model._convert_messages(messages)return ResponsesTransport.input_from_messages(converted)def _remember_llm_result_state(diff --git a/docs/README.md b/docs/README.mdindex 655dc0e44..c83dd4f47 100644--- a/docs/README.md+++ b/docs/README.md@@ -27,7 +27,7 @@ docs focus on practical setup, screenshots, and user workflows.- **[Desktop Guide](guides/desktop.md):** Use the built-in Linux desktop, GUI apps, and LibreOffice Writer/Calc/Impress Cowork.- **[A0 CLI Connector](guides/a0-cli-connector.md):** Terminal-first host connector for Agent Zero, with screenshots of the host picker, connected shell, command palette, and Browser modes.- **[Create a Small Plugin](guides/create-plugin.md):** Build and review a tiny Web UI plugin that adds an unread dot to the chat list.-- **[Skills Guide](guides/skills.md):** Open the Skills selector, add active skills, and remove prompt extras you no longer need.+- **[Skills Guide](guides/skills.md):** Open the Skills selector, add active skills, and remove prompt protocol entries you no longer need.- **[Agent Profiles](guides/agent-profiles.md):** Switch the current chat profile or create a new guided profile from the chat input.- **[Model Presets](guides/model-presets.md):** Create simple named shortcuts for model setups.- **[Memory Guide](guides/memory.md):** Search, edit, delete, and curate memories so useful context does not become stale noise.diff --git a/docs/guides/model-presets.md b/docs/guides/model-presets.mdindex 18f3bc0f2..ff23a06fd 100644--- a/docs/guides/model-presets.md+++ b/docs/guides/model-presets.md@@ -83,7 +83,7 @@ You can always rename them later.| **Model Preset** | Which models power the chat. || **Agent Profile** | The agent's role, tone, and prompt behavior. || **Project** | Workspace, files, memory, secrets, and project instructions. |-| **Skill** | A specific procedure added to prompt extras. |+| **Skill** | A specific procedure added to prompt protocol. |For example, you can use the same "Researcher" Agent Profile with a cheaperpreset for simple questions and a stronger preset for difficult investigations.diff --git a/docs/guides/skills.md b/docs/guides/skills.mdindex 215d87586..3a959d157 100644--- a/docs/guides/skills.md+++ b/docs/guides/skills.md@@ -29,7 +29,7 @@ Click a skill to add it. Active skills are shown at the top of the selector.To remove a skill, use the remove button in **Active skills** or uncheck it inthe list.-Active skills are added to the **Extras** part of the system prompt. That means+Active skills are added to the **Protocol** part of the prompt. That meansAgent Zero sees them every turn while they are active.> [!TIP]@@ -56,7 +56,7 @@ usually easier for the agent to follow.| Control | What it changes || --- | --- |-| **Skills** | Adds a specific procedure to the current prompt extras. |+| **Skills** | Adds a specific procedure to the current prompt protocol. || **Agent Profiles** | Changes the broader role and behavior of the chat. || **Projects** | Adds workspace, files, memory, secrets, and project instructions. |diff --git a/docs/guides/usage.md b/docs/guides/usage.mdindex d5bc931e5..76dda859c 100644--- a/docs/guides/usage.md+++ b/docs/guides/usage.md@@ -74,7 +74,7 @@ Use the selector to add or remove active skills.-Active skills are added to the **Extras** part of the system prompt, so keep the+Active skills are added to the **Protocol** part of the prompt, so keep thelist short and intentional. See the [Skills guide](skills.md).### Agent Profilesdiff --git a/docs/quickstart.md b/docs/quickstart.mdindex 59c569fe3..4d31103f9 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -141,7 +141,7 @@ Explains how to search, edit, delete, export, and curate memories before stale c### [Open A0 Skills Guide](guides/skills.md)-Shows the chat input **+** menu, the Skills selector, and how active skills are added to prompt extras.+Shows the chat input **+** menu, the Skills selector, and how active skills are added to prompt protocol.### [Open A0 Agent Profiles Guide](guides/agent-profiles.md)diff --git a/extensions/python/AGENTS.md b/extensions/python/AGENTS.mdindex 270a98afd..079c0ca5b 100644--- a/extensions/python/AGENTS.md+++ b/extensions/python/AGENTS.md@@ -44,7 +44,7 @@ Direct child DOX files:| [hist_add_tool_result/AGENTS.md](hist_add_tool_result/AGENTS.md) | Tool-result history side effects. || [job_loop/AGENTS.md](job_loop/AGENTS.md) | Periodic backend maintenance jobs. || [message_loop_end/AGENTS.md](message_loop_end/AGENTS.md) | End-of-message-loop history and persistence behavior. |-| [message_loop_prompts_after/AGENTS.md](message_loop_prompts_after/AGENTS.md) | Prompt extras appended after message-loop prompt construction. |+| [message_loop_prompts_after/AGENTS.md](message_loop_prompts_after/AGENTS.md) | Prompt protocol and extras assembled around message-loop prompt construction. || [message_loop_prompts_before/AGENTS.md](message_loop_prompts_before/AGENTS.md) | Pre-prompt-construction message-loop gates. || [message_loop_start/AGENTS.md](message_loop_start/AGENTS.md) | Start-of-message-loop iteration state. || [monologue_end/AGENTS.md](monologue_end/AGENTS.md) | End-of-monologue UI and cleanup behavior. |diff --git a/extensions/python/message_loop_prompts_after/AGENTS.md b/extensions/python/message_loop_prompts_after/AGENTS.mdindex 441540972..cfd2702b4 100644--- a/extensions/python/message_loop_prompts_after/AGENTS.md+++ b/extensions/python/message_loop_prompts_after/AGENTS.md@@ -2,11 +2,12 @@## Purpose-- Own prompt extras appended after primary message-loop prompt construction.+- Own prompt protocol and extras appended around primary message-loop prompt construction.## Ownership- Ordered Python files own current datetime, skill recall/load context, agent info, parallel job status, and workdir extras injection.+- Loaded and active skill instructions belong in prompt protocol, not prompt extras.## Local Contracts@@ -16,11 +17,11 @@## Work Guidance-- Coordinate prompt-extra changes with skill, workdir, and profile contracts.+- Coordinate prompt protocol and prompt-extra changes with skill, workdir, and profile contracts.## Verification-- Inspect rendered prompt extras or run prompt-construction tests after changes.+- Inspect rendered prompt protocol/extras or run prompt-construction tests after changes.## Child DOX Indexdiff --git a/extensions/python/message_loop_prompts_after/_65_include_loaded_skills.py b/extensions/python/message_loop_prompts_after/_65_include_loaded_skills.pyindex b3f88f988..8f667bbe2 100644--- a/extensions/python/message_loop_prompts_after/_65_include_loaded_skills.py+++ b/extensions/python/message_loop_prompts_after/_65_include_loaded_skills.py@@ -9,7 +9,8 @@ class IncludeLoadedSkills(Extension):if not self.agent:return- extras = loop_data.extras_persistent+ protocol = loop_data.protocol_persistent+ protocol.pop("loaded_skills", None)# Get loaded skills namesskill_names = self.agent.data.get(DATA_NAME_LOADED_SKILLS)@@ -31,8 +32,8 @@ class IncludeLoadedSkills(Extension):return- # Inject into extras- extras["loaded_skills"] = self.agent.read_prompt(+ # Inject into protocol+ protocol["loaded_skills"] = self.agent.read_prompt("agent.system.skills.loaded.md",skills=content,)diff --git a/extensions/python/system_prompt/AGENTS.md b/extensions/python/system_prompt/AGENTS.mdindex bc4ee6448..34b90f78c 100644--- a/extensions/python/system_prompt/AGENTS.md+++ b/extensions/python/system_prompt/AGENTS.md@@ -7,6 +7,7 @@## Ownership- Ordered Python files own main, tools, MCP, secrets, skills, and project prompt sections.+- Active project instruction bodies are moved into prompt protocol; the system prompt keeps project metadata and stable project rules.## Local Contractsdiff --git a/extensions/python/system_prompt/_14_project_prompt.py b/extensions/python/system_prompt/_14_project_prompt.pyindex 41948f5ed..cd0363b4c 100644--- a/extensions/python/system_prompt/_14_project_prompt.py+++ b/extensions/python/system_prompt/_14_project_prompt.py@@ -15,17 +15,24 @@ class ProjectPrompt(Extension):):if not self.agent:return- prompt = await build_prompt(self.agent)+ prompt = await build_prompt(self.agent, loop_data=loop_data)if prompt:system_prompt.append(prompt)@extensible-async def build_prompt(agent: Agent) -> str:+async def build_prompt(agent: Agent, loop_data: LoopData | None = None) -> str:result = agent.read_prompt("agent.system.projects.main.md")project_name = agent.context.get_data(projects.CONTEXT_DATA_KEY_PROJECT)+ if loop_data:+ loop_data.protocol_persistent.pop("project_instructions", None)if project_name:project_vars = projects.build_system_prompt_vars(project_name)+ if loop_data and project_vars.get("project_instructions"):+ loop_data.protocol_persistent["project_instructions"] = agent.read_prompt(+ "agent.protocol.projects.instructions.md",+ **project_vars,+ )result += "\n\n" + agent.read_prompt("agent.system.projects.active.md", **project_vars)diff --git a/plugins/_skills/AGENTS.md b/plugins/_skills/AGENTS.mdindex 1371f2bf9..ebb1af367 100644--- a/plugins/_skills/AGENTS.md+++ b/plugins/_skills/AGENTS.md@@ -2,7 +2,7 @@## Purpose-- Own active and hidden skill configuration injected into prompt extras on each turn.+- Own active and hidden skill configuration injected into prompt protocol on each turn.## Ownershipdiff --git a/plugins/_skills/README.md b/plugins/_skills/README.mdindex 3266b93cf..4d27c4f96 100644--- a/plugins/_skills/README.md+++ b/plugins/_skills/README.md@@ -6,7 +6,7 @@ Skills is a built-in Agent Zero plugin that manages active skills across scope d- pins default skills for the current plugin scope- hides noisy skills from the model-facing available catalog, skill search, and load access-- injects the effective active skills into prompt extras on every turn+- injects the effective active skills into prompt protocol on every turn- extends the same config screen with a current-chat mode so users can activate or hide skills live per conversation- supports global and project scoped configurations without agent-profile variants- links directly to the built-in Skills list@@ -21,7 +21,7 @@ The shared active-skill state and prompt-resolution logic live in `helpers/skill## Notes-- keep the active list short because every active skill is injected into prompt extras every turn+- keep the active list short because every active skill is injected into prompt protocol every turn- the default cap is 20 active skills, and it can be raised or lowered in Skills plugin config- hidden skills are not capped because they are stored as control data, not injected into the prompt- selected skills are stored in normalized `/a0/...` form so configs stay portable across development and Docker-style layoutsdiff --git a/plugins/_skills/extensions/python/message_loop_prompts_after/_66_include_active_skills.py b/plugins/_skills/extensions/python/message_loop_prompts_after/_66_include_active_skills.pyindex fc10cc0c8..ea9ced8b5 100644--- a/plugins/_skills/extensions/python/message_loop_prompts_after/_66_include_active_skills.py+++ b/plugins/_skills/extensions/python/message_loop_prompts_after/_66_include_active_skills.py@@ -10,14 +10,14 @@ class IncludeActiveSkills(Extension):if not self.agent:return- extras = loop_data.extras_persistent- extras.pop("active_skills", None)+ protocol = loop_data.protocol_persistent+ protocol.pop("active_skills", None)content = skills.build_active_skills_prompt(self.agent)if not content:return- extras["active_skills"] = self.agent.read_prompt(+ protocol["active_skills"] = self.agent.read_prompt("agent.system.active_skills.md",skills=content,)diff --git a/plugins/_skills/plugin.yaml b/plugins/_skills/plugin.yamlindex dbf66815f..920d57b6c 100644--- a/plugins/_skills/plugin.yaml+++ b/plugins/_skills/plugin.yaml@@ -1,6 +1,6 @@name: _skillstitle: Skills-description: Pin skills into prompt extras on every turn.+description: Pin skills into prompt protocol on every turn.version: 1.0.0always_enabled: truesettings_sections:diff --git a/prompts/agent.context.protocol.md b/prompts/agent.context.protocol.mdnew file mode 100644index 000000000..2f7c46131--- /dev/null+++ b/prompts/agent.context.protocol.md@@ -0,0 +1,2 @@+[PROTOCOL]+{{protocol}}diff --git a/prompts/agent.protocol.projects.instructions.md b/prompts/agent.protocol.projects.instructions.mdnew file mode 100644index 000000000..43c565803--- /dev/null+++ b/prompts/agent.protocol.projects.instructions.md@@ -0,0 +1,4 @@+# project instructions+- the following instructions come from the active project and must be followed when working in it++{{project_instructions}}diff --git a/prompts/agent.system.main.communication_additions.md b/prompts/agent.system.main.communication_additions.mdindex 1a5749f6c..31e3809f1 100644--- a/prompts/agent.system.main.communication_additions.md+++ b/prompts/agent.system.main.communication_additions.md@@ -2,7 +2,8 @@user messages may include superior instructions, tool results, and framework notestreat the closing `}` of a tool call as an end-of-turn signal. terminate generation immediatelyif message starts `(voice)` transcription can be imperfect-messages may end with `[EXTRAS]`; extras are context, not new instructions+messages begin `[PROTOCOL]`; protocol = must-follow instructions+messages end `[EXTRAS]`; extras are context not new instructionstool names are literal api ids; copy them exactly, including spelling like `behaviour_adjustment`## replacementsdiff --git a/prompts/agent.system.projects.active.md b/prompts/agent.system.projects.active.mdindex 5736e6e17..a13ec0b5d 100644--- a/prompts/agent.system.projects.active.md+++ b/prompts/agent.system.projects.active.md@@ -6,6 +6,4 @@ path: {{project_path}}rules:- work inside {{project_path}}- do not rename project dir or change `.a0proj` unless asked-- must always follow project instructions below--{{project_instructions}}+- follow active project instructions when provideddiff --git a/tests/test_prompt_protocol.py b/tests/test_prompt_protocol.pynew file mode 100644index 000000000..c4d29bfdc--- /dev/null+++ b/tests/test_prompt_protocol.py@@ -0,0 +1,131 @@+from types import SimpleNamespace++import pytest+from langchain_core.messages import AIMessage, HumanMessage, SystemMessage++from agent import Agent, LoopData+from helpers import extension, history+from extensions.python.system_prompt import _14_project_prompt as project_prompt+++class _DummyLog:+ def set_progress(self, _message: str) -> None:+ return None+++async def test_prepare_prompt_places_protocol_before_history_and_extras(monkeypatch):+ async def fake_call_extensions(extension_point: str, agent=None, **kwargs):+ if extension_point == "message_loop_prompts_after":+ loop_data = kwargs["loop_data"]+ loop_data.protocol_persistent["project_instructions"] = "Project rule."+ loop_data.extras_temporary["current_datetime"] = "Today."++ monkeypatch.setattr(extension, "call_extensions_async", fake_call_extensions)+ monkeypatch.setattr(history.History, "_get_max_embeds", lambda self: 0)++ agent = object.__new__(Agent)+ loop_data = LoopData()+ agent.loop_data = loop_data+ agent.context = SimpleNamespace(log=_DummyLog())+ agent.history = history.History(agent)+ agent.data = {}++ agent.history.add_message(False, "User asks.")+ agent.history.add_message(True, "Assistant answers.")++ async def get_system_prompt(_loop_data):+ return ["System root."]++ def read_prompt(prompt_file: str, **kwargs) -> str:+ if prompt_file == "agent.context.protocol.md":+ return "[PROTOCOL]\n" + kwargs["protocol"]+ if prompt_file == "agent.context.extras.md":+ return "[EXTRAS]\n" + kwargs["extras"]+ raise AssertionError(f"Unexpected prompt file: {prompt_file}")++ agent.get_system_prompt = get_system_prompt+ agent.read_prompt = read_prompt+ agent.set_data = lambda key, value: agent.data.__setitem__(key, value)++ prompt = await Agent.prepare_prompt(agent, loop_data)++ assert isinstance(prompt[0], SystemMessage)+ assert prompt[0].content == "System root."+ assert isinstance(prompt[1], HumanMessage)+ assert str(prompt[1].content).startswith("[PROTOCOL]")+ assert str(prompt[1].content).index("Project rule.") < str(prompt[1].content).index(+ "User asks."+ )+ assert isinstance(prompt[2], AIMessage)+ assert prompt[2].content == "Assistant answers."+ assert isinstance(prompt[3], HumanMessage)+ assert str(prompt[3].content).startswith("[EXTRAS]")+ assert "Today." in str(prompt[3].content)++ serialized_history = agent.history.serialize()+ assert "Project rule." not in serialized_history+ assert "Today." not in serialized_history+ assert "protocol" not in serialized_history.lower()+ assert loop_data.protocol_temporary == {}+ assert loop_data.extras_temporary == {}++ class FakeResponsesModel:+ def _convert_messages(self, messages):+ role_by_type = {"system": "system", "human": "user", "ai": "assistant"}+ return [+ {"role": role_by_type[message.type], "content": message.content}+ for message in messages+ ]++ input_items = Agent._responses_prompt_input_items(+ agent,+ FakeResponsesModel(),+ prompt,+ )+ assert input_items[1]["role"] == "user"+ assert "[PROTOCOL]" in input_items[1]["content"]+ assert "[EXTRAS]" in input_items[-1]["content"]+++async def test_project_prompt_moves_project_instructions_to_protocol(monkeypatch):+ project_vars = {+ "project_name": "Demo",+ "project_description": "",+ "project_instructions": "Project rule.",+ "project_path": "/a0/usr/projects/demo",+ "project_git_url": "",+ }+ loop_data = LoopData()++ class FakeContext:+ def get_data(self, key):+ assert key == project_prompt.projects.CONTEXT_DATA_KEY_PROJECT+ return "demo"++ class FakeAgent:+ context = FakeContext()++ def read_prompt(self, prompt_file: str, **kwargs) -> str:+ if prompt_file == "agent.system.projects.main.md":+ return "project context may be active"+ if prompt_file == "agent.system.projects.active.md":+ return f"active project: {kwargs['project_path']}"+ if prompt_file == "agent.protocol.projects.instructions.md":+ return "protocol project instructions:\n" + kwargs["project_instructions"]+ raise AssertionError(f"Unexpected prompt file: {prompt_file}")++ monkeypatch.setattr(+ project_prompt.projects,+ "build_system_prompt_vars",+ lambda _name: project_vars,+ )++ prompt = await project_prompt.build_prompt.__wrapped__( # type: ignore[attr-defined]+ FakeAgent(),+ loop_data=loop_data,+ )++ assert "Project rule." not in prompt+ assert "Project rule." in loop_data.protocol_persistent["project_instructions"]diff --git a/tests/test_tool_action_contracts.py b/tests/test_tool_action_contracts.pyindex 8bd638ecb..f689cc232 100644--- a/tests/test_tool_action_contracts.py+++ b/tests/test_tool_action_contracts.py@@ -146,6 +146,24 @@ def test_skills_tool_accepts_action_alias_for_search(monkeypatch, tmp_path: Pathassert "browser-form-workflows" in response.message+def test_skills_tool_load_reports_protocol_injection(monkeypatch, tmp_path: Path):+ module = _load_skills_tool(monkeypatch, tmp_path)+ agent = _FakeAgent()+ tool = module.SkillsTool(+ agent,+ "skills_tool",+ None,+ {"action": "load", "skill_name": "browser-form-workflows"},+ "",+ None,+ )++ response = asyncio.run(tool.execute(**tool.args))++ assert response.message == "Loaded skill 'browser-form-workflows' into Protocol."+ assert agent.data["loaded_skills"] == ["browser-form-workflows"]++def test_skills_tool_read_file_action_reads_inside_skill_dir(monkeypatch, tmp_path: Path):diff --git a/tools/skills_tool.py b/tools/skills_tool.pyindex 3c566fa67..f5ccc4474 100644--- a/tools/skills_tool.py+++ b/tools/skills_tool.py@@ -209,7 +209,7 @@ class SkillsTool(Tool):loaded.append(skill.name)self.agent.data[DATA_NAME_LOADED_SKILLS] = loaded[-max_loaded_skills():]- return f"Loaded skill '{skill.name}' into EXTRAS."+ return f"Loaded skill '{skill.name}' into Protocol."def _read_file(self, skill_name: str, file_path: str) -> str:if not skill_name:diff --git a/tools/skills_tool.py.dox.md b/tools/skills_tool.py.dox.mdindex e93b91e50..d838d8302 100644--- a/tools/skills_tool.py.dox.md+++ b/tools/skills_tool.py.dox.md@@ -25,6 +25,7 @@- Update this file whenever tool arguments, output shape, `break_loop` behavior, intervention handling, prompt instructions, or side effects change.- `SkillsTool` is a `Tool`.- `SkillsTool` defines `execute(...)`.+- Loading a skill stores it for prompt Protocol injection on subsequent turns.- Observed side-effect areas: filesystem reads, filesystem deletion, settings/state persistence.- Imported dependency areas include: `__future__`, `helpers`, `helpers.print_style`, `helpers.tool`, `pathlib`, `typing`.