agent-zero/plugins/_skills/AGENTS.md
frdel e138e33ca9 Add file-level DOX docs & update AGENTS indexes
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.
2026-06-08 12:41:53 +02:00

1,019 B

Skills Plugin DOX

Purpose

  • Own active and hidden skill configuration injected into prompt extras on each turn.

Ownership

  • hooks.py owns skill prompt injection and plugin lifecycle behavior.
  • api/skills_catalog.py owns skill catalog access.
  • prompts/agent.system.active_skills.md owns injected active-skill prompt content.
  • webui/ owns skill settings UI and store.
  • default_config.yaml, plugin.yaml, README.md, and LICENSE own defaults, metadata, docs, and license.

Local Contracts

  • Keep active skill lists bounded by configured caps.
  • Store configured skills in normalized portable paths.
  • Hidden skills affect catalog/search/load visibility but must not be injected as active prompt content.

Work Guidance

  • Coordinate active-skill resolution changes with core skill loading and settings UI.

Verification

  • Run skill runtime/catalog tests or smoke-test active, hidden, global, project, and chat-scope behavior after changes.

Child DOX Index

No child DOX files.