--- name: build-skill-6696ae731db1 description: "Create, rename, move, audit, test or refine Agent Zero skills and reusable workflows." --- # Build Skill Skills are small folders that teach Agent Zero a repeatable workflow. Keep the always-visible metadata precise, keep `SKILL.md` lean, and move detailed material into scripts, references, or assets only when the task needs it. ## Standard Shape Every skill folder must be named exactly like the skill and contain `SKILL.md`. ```text skill-name/ ├── SKILL.md ├── scripts/ # optional deterministic helpers ├── references/ # optional details loaded only when needed └── assets/ # optional output resources or templates ``` The frontmatter should contain `name`, `description`, and optional `triggers` when lexical discovery needs phrases that do not fit naturally in the description: ```yaml --- name: skill-name description: What the skill does and when to use it. triggers: - "user phrase that should surface this skill" --- ``` Use lowercase letters, digits, and hyphens. Prefer short verb-led names such as `build-skill`, `review-plugin`, or `host-file-editing`. ## Workflow 1. Identify two or three real user requests that should trigger the skill. 2. Decide whether the skill belongs in core `skills/` or inside a plugin's `plugins//skills/` directory. 3. Write the frontmatter description with the core trigger condition and key context; add `triggers` for short user phrases that should rank highly in skill search or relevant-skill recall. 4. Keep the body focused on procedure, contracts, failure handling, and the files/scripts to load next. 5. Move long examples, schemas, policies, or variant-specific detail to one-level-deep `references/` files. 6. Add scripts only for deterministic or repeatedly rewritten operations, and test representative scripts. 7. Validate by searching, loading, and using the skill on a median-user prompt. ## Placement Use plugin-scoped skills when the skill exists to explain a plugin-owned tool or UI surface. Examples: Browser workflows belong under `_browser`; A0 CLI host tools belong under `_a0_connector`; Desktop canvas workflows belong under `_desktop`. Use root `skills/` for Agent Zero framework workflows that are not owned by one plugin, such as building skills, developing core features, or managing community plugins. ## Writing Rules - Put trigger language in frontmatter, not in a body section. Use `description` for the compact always-visible purpose and `triggers` for phrase matches used by search and relevant-skill recall. - Do not add README, changelog, quick reference, or install guide files inside the skill. - Avoid compatibility aliases in prompts or skill bodies when renaming; update references to the new name. - Prefer concise examples over long prose. - Do not duplicate the same guidance in both `SKILL.md` and references. - When multiple skills could apply, keep each skill's responsibility narrow and name the handoff clearly. ## Validation Run targeted checks after edits: ```bash conda run -n a0 pytest tests/test_skills_runtime.py tests/test_tool_action_contracts.py -q ``` Also exercise the live path when the skill changes agent-facing tool behavior: ```text 1. Ask a short ordinary prompt that should discover the skill. 2. Confirm the agent uses skills_tool search/load when appropriate. 3. Confirm it calls the intended tool only after the skill is loaded when the tool is skill-gated. ``` --- Source attribution: agent0ai Original project: https://github.com/agent0ai/agent-zero License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Gabriel Moreira Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: agent0ai Original project: https://github.com/agent0ai/agent-zero Attribution basis: Upstream repository explicitly recorded in package mirror path Fields of work: Operations, Product Management, Sales Roles: Growth Product Manager, Operations Manager, Product Manager, Sales Development Rep (SDR), Technical Product Manager Specialties: Specialty not specified Tools: Tool not specified Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 419e7b36e3c51ca1b84b6253a276f2616b635216529f67441c400852c9367630