mirror of
https://github.com/agent0ai/agent-zero.git
synced 2026-07-10 01:18:29 +00:00
e138e33ca9
Add comprehensive file-level DOX documentation across the repo and update directory AGENTS.md indexes. Many new `*.py.dox.md` files were added under api, helpers, tools, plugins, extensions, webui, and other dirs to document endpoint purpose, ownership, runtime contracts, work guidance, and verification. Several AGENTS.md files were created or updated (agents profiles, api, docker, extensions, helpers, plugins, skills, webui components, etc.) to list child DOX files and clarify documentation/work guidance. Also add example and bundled profile DOX files (agent0, default, developer, hacker, researcher) and minor updates to helpers/dirty_json.py and its tests. These changes improve on-disk documentation coverage and establish the convention that each direct runtime file should have a matching `*.dox.md` describing its contracts and verification steps. |
||
|---|---|---|
| .. | ||
| api | ||
| extensions | ||
| helpers | ||
| prompts | ||
| webui | ||
| __init__.py | ||
| AGENTS.md | ||
| default_config.yaml | ||
| hooks.py | ||
| LICENSE | ||
| plugin.yaml | ||
| README.md | ||
Skills
Skills is a built-in Agent Zero plugin that manages active skills across scope defaults and the current chat.
What It Does
- 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
- 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
- links directly to the active project's Skills section when a project is active
Why This Exists
Agent Zero already supports loading skills dynamically with skills_tool, and already has great built-in skill management surfaces. What it did not have was a lightweight way to make a few skills feel "always on" for a specific scope without modifying the core prompt system.
Skills fills that gap as a bundled built-in plugin.
The shared active-skill state and prompt-resolution logic live in helpers/skills.py, and this plugin focuses on configuration, UI, and prompt injection.
Notes
- keep the active list short because every active skill is injected into prompt extras 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 layouts - scope defaults can be hidden or supplemented per chat without creating a new conversation
- if a configured skill is not visible in the current agent scope, it is skipped quietly instead of breaking the prompt build