vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-07-09 17:08:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
agent-zero/tools/skills_tool.py.dox.md
Alessandro bf2741990a
Some checks are pending
Build And Publish Docker Images / plan (push) Waiting to run
Details
Build And Publish Docker Images / build (push) Blocked by required conditions
Details
Revert loaded skill history persistence 
Reverts db01d7c1c8 and 3c83b2eca2.

Restores the prior loaded-skills prompt-extras behavior and removes the compaction reattachment metadata path.
2026-06-18 16:45:56 +02:00

2.5 KiB
Raw Blame History

skills_tool.py DOX

Purpose

  • Own the skills_tool.py agent tool.
  • This module searches, loads, and lists Agent Zero skills for the agent.
  • Keep this file-level DOX profile synchronized with skills_tool.py because this directory is intentionally flat.

Ownership

  • skills_tool.py owns the runtime implementation.
  • skills_tool.py.dox.md owns durable notes about responsibilities, contracts, side effects, and verification for that implementation.
  • Classes:
  • SkillsTool (Tool)
    • get_log_object(self)
    • async before_execution(self, **kwargs)
    • async execute(self, **kwargs) -> Response
  • Top-level functions:
  • max_loaded_skills() -> int
  • Notable constants/configuration names: DATA_NAME_LOADED_SKILLS.

Runtime Contracts

  • Tool modules must define helpers.tool.Tool subclasses and return helpers.tool.Response from execute(...).
  • 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(...).
  • Observed side-effect areas: filesystem reads, filesystem deletion, settings/state persistence.
  • Imported dependency areas include: __future__, helpers, helpers.print_style, helpers.tool, pathlib, typing.

Key Concepts

  • Important called helpers/classes observed in the source: str.strip.lower.replace, skill_name.strip, super.get_log_object, self._normalize_skill_name, self.get_log_object, skills_helper.list_skills, join, skills_helper.search_skills, skills_helper.find_skill, skill.path.resolve, Path, resolved.read_text, skill_name.startswith, skill_name.endswith, self._current_action, self.agent.context.log.log, Response, strip, loaded.remove, target.is_absolute.
  • Keep request/response, tool, or helper semantics documented here at the same time as source changes.

Work Guidance

  • Keep tool output concise, model-readable, and safe for history persistence.
  • Coordinate argument or behavior changes with prompt tool instructions and skill guidance.
  • Respect intervention flow for long-running, external, or user-visible operations.

Verification

  • Run targeted tool and prompt-contract tests for changed behavior; smoke-test agent execution when no focused test exists.
  • Related tests observed by source search:
    • tests/test_document_query_plugin.py
    • tests/test_tool_action_contracts.py

Child DOX Index

No child DOX files.