Agent Zero AI framework
feat: skills list UI and APIs
3clyp50717f69f3971d
diff --git a/python/api/skills.py b/python/api/skills.pynew file mode 100644index 000000000..b8fc3328a--- /dev/null+++ b/python/api/skills.py@@ -0,0 +1,75 @@+from python.helpers.api import ApiHandler, Input, Output, Request, Response+from python.helpers import skills+++def _coerce_bool(value) -> bool:+ if isinstance(value, bool):+ return value+ if isinstance(value, str):+ return value.strip().lower() in ("1", "true", "yes", "on")+ return bool(value)+++class Skills(ApiHandler):+ async def process(self, input: Input, request: Request) -> Output:+ action = input.get("action", "")++ try:+ if action == "list":+ data = self.list_skills(input)+ elif action == "toggle":+ data = self.toggle_skill(input)+ elif action == "delete":+ data = self.delete_skill(input)+ else:+ raise Exception("Invalid action")++ return {+ "ok": True,+ "data": data,+ }+ except Exception as e:+ return {+ "ok": False,+ "error": str(e),+ }++ def list_skills(self, input: Input):+ project_name = (input.get("project_name") or "").strip() or None+ profile_name = (input.get("profile_name") or "").strip() or None+ return skills.get_skills_list(+ project_name=project_name,+ profile_name=profile_name+ )++ def toggle_skill(self, input: Input):+ skill_id = str(input.get("skill_id") or "").strip()+ if not skill_id:+ raise Exception("skill_id is required")++ enabled = _coerce_bool(input.get("enabled", True))+ project_name = (input.get("project_name") or "").strip() or None+ profile_name = (input.get("profile_name") or "").strip() or None++ skills.set_skill_activation(+ skill_id,+ enabled=enabled,+ project_name=project_name,+ profile_name=profile_name,+ )+ return {"enabled": enabled}++ def delete_skill(self, input: Input):+ skill_id = str(input.get("skill_id") or "").strip()+ if not skill_id:+ raise Exception("skill_id is required")++ project_name = (input.get("project_name") or "").strip() or None+ profile_name = (input.get("profile_name") or "").strip() or None++ skills.delete_skill(+ skill_id,+ project_name=project_name,+ profile_name=profile_name,+ )+ return {"skill_id": skill_id}diff --git a/python/extensions/system_prompt/_10_system_prompt.py b/python/extensions/system_prompt/_10_system_prompt.pyindex 40fc5f030..272ec7e8a 100644--- a/python/extensions/system_prompt/_10_system_prompt.py+++ b/python/extensions/system_prompt/_10_system_prompt.py@@ -85,7 +85,7 @@ def get_project_prompt(agent: Agent):return resultdef get_skills_prompt(agent: Agent):- available = skills.list_skills(agent)+ available = skills.list_skills(agent=agent, enabled_only=True)result = []for skill in available:name = skill.name.strip().replace("\n", " ")[:100]diff --git a/python/helpers/skills.py b/python/helpers/skills.pyindex 092cd233c..7b2ad8d38 100644--- a/python/helpers/skills.py+++ b/python/helpers/skills.py@@ -6,7 +6,7 @@ from dataclasses import dataclass, fieldfrom pathlib import Pathfrom typing import Any, Dict, Iterable, List, Literal, Optional, Tuple, TYPE_CHECKING-from python.helpers import files, subagents+from python.helpers import files, subagents, dirty_json, projectsif TYPE_CHECKING:from agent import Agent@@ -286,7 +286,9 @@ def skill_from_markdown(def list_skills(agent:Agent|None=None,include_content: bool = False,+ enabled_only: bool = False,) -> List[Skill]:+ """List skills, optionally filtered by agent scope and enabled status."""skills: List[Skill] = []roots = get_skill_roots(agent)@@ -299,6 +301,8 @@ def list_skills(# no deduplication for global skillsif not agent:+ if enabled_only:+ skills = filter_enabled_skills(skills, agent=None)return skills# Dedupe by normalized name, preserving root_order priority (earlier wins)@@ -307,7 +311,268 @@ def list_skills(key = _normalize_name(s.name) or _normalize_name(s.path.name)if key and key not in by_name:by_name[key] = s- return list(by_name.values())++ result = list(by_name.values())++ if enabled_only:+ result = filter_enabled_skills(result, agent=agent)++ return result+++def _get_activation_file(project_name: str | None, profile_name: str | None) -> str:+ """Get the activation file path for the given scope."""+ if project_name and profile_name:+ return files.deabsolute_path(+ projects.get_project_meta_folder(project_name, "agents", profile_name, "skills.json")+ )+ elif project_name:+ return files.deabsolute_path(+ projects.get_project_meta_folder(project_name, "skills.json")+ )+ elif profile_name:+ return files.get_abs_path(subagents.USER_AGENTS_DIR, profile_name, "skills.json")+ return files.get_abs_path(subagents.USER_DIR, "skills", "skills.json")+++def _load_activation_map(path: str) -> Dict[str, bool]:+ try:+ if not files.exists(path):+ return {}+ parsed = dirty_json.parse(files.read_file(path))+ if not isinstance(parsed, dict):+ return {}+ result: Dict[str, bool] = {}+ for key, value in parsed.items():+ result[str(key)] = bool(value)+ return result+ except Exception:+ return {}+++def _write_activation_map(path: str, data: Dict[str, bool]) -> None:+ content = dirty_json.stringify(data, indent=2)+ files.write_file(path, content)+++def _get_skill_roots_for_list(+ project_name: str | None = None,+ profile_name: str | None = None,+) -> List[str]:+ """Get skill root directories for the specified scope."""+ roots: List[str] = []++ # global roots+ roots.append(files.get_abs_path("skills"))+ roots.append(files.get_abs_path("usr", "skills"))++ # project roots+ if project_name:+ if profile_name:+ roots.append(projects.get_project_meta_folder(project_name, "agents", profile_name, "skills"))+ roots.append(projects.get_project_meta_folder(project_name, "skills"))++ # agent roots+ if profile_name:+ roots.append(files.get_abs_path(subagents.USER_AGENTS_DIR, profile_name, "skills"))+ roots.append(files.get_abs_path(subagents.DEFAULT_AGENTS_DIR, profile_name, "skills"))++ # dedupe and filter existing+ seen: set[str] = set()+ result: List[str] = []+ for root in roots:+ if root in seen or not os.path.isdir(root):+ continue+ seen.add(root)+ result.append(root)+ return result+++def _get_scope_info(root: str, project_name: str | None, profile_name: str | None) -> Dict[str, str]:+ """Determine scope metadata for a skill root."""+ # determine origin+ origin = "default"+ if files.is_in_base_dir(root):+ rel = files.deabsolute_path(root)+ if rel.startswith("usr/") or rel.startswith("projects/"):+ origin = "user"+ if rel.startswith("projects/"):+ origin = "project"++ # determine scope+ scope = "global"+ scope_name = "global"++ if project_name and profile_name and ".a0proj" in root and "agents" in root:+ scope = "project_agent"+ scope_name = f"{project_name}:{profile_name}"+ elif project_name and ".a0proj" in root:+ scope = "project"+ scope_name = project_name+ elif profile_name and f"agents/{profile_name}" in root:+ scope = "agent"+ scope_name = profile_name++ return {+ "scope": scope,+ "scope_name": scope_name,+ "origin": origin,+ }+++def get_skills_list(+ project_name: str | None = None,+ profile_name: str | None = None,+) -> List[Dict[str, Any]]:+ """Get list of all skills with activation status."""+ roots = _get_skill_roots_for_list(project_name, profile_name)+ activation_file = _get_activation_file(project_name, profile_name)+ activation_map = _load_activation_map(activation_file)++ entries: List[Dict[str, Any]] = []+ for root in roots:+ scope_info = _get_scope_info(root, project_name, profile_name)++ for skill_md in discover_skill_md_files(Path(root)):+ skill = skill_from_markdown(skill_md, include_content=False)+ if not skill:+ continue++ # generate skill_id+ rel_path = os.path.relpath(str(skill.path), root).replace("\\", "/")+ skill_id = f"{root}:{rel_path}"+ enabled = activation_map.get(skill_id, True)++ entries.append(+ {+ "skill_id": skill_id,+ "name": skill.name,+ "description": skill.description,+ "location": files.normalize_a0_path(str(skill.path)),+ "root": files.normalize_a0_path(root),+ "scope": scope_info["scope"],+ "scope_name": scope_info["scope_name"],+ "origin": scope_info["origin"],+ "enabled": bool(enabled),+ }+ )+ return entries+++def set_skill_activation(+ skill_id: str,+ enabled: bool,+ project_name: str | None = None,+ profile_name: str | None = None,+) -> None:+ """Toggle skill activation."""+ if not skill_id or ":" not in skill_id:+ raise ValueError("Invalid skill_id")++ root, _ = skill_id.split(":", 1)+ allowed_roots = _get_skill_roots_for_list(project_name, profile_name)++ if root not in allowed_roots:+ raise ValueError("Skill root not in current scope")++ activation_file = _get_activation_file(project_name, profile_name)+ activation_map = _load_activation_map(activation_file)++ if enabled:+ activation_map.pop(skill_id, None)+ else:+ activation_map[skill_id] = False++ _write_activation_map(activation_file, activation_map)+++def delete_skill(+ skill_id: str,+ project_name: str | None = None,+ profile_name: str | None = None,+) -> None:+ """Delete a skill directory."""+ if not skill_id or ":" not in skill_id:+ raise ValueError("Invalid skill_id")++ root, rel_path = skill_id.split(":", 1)+ if not rel_path or rel_path in ("", "."):+ raise ValueError("Cannot delete root directory")++ allowed_roots = _get_skill_roots_for_list(project_name, profile_name)+ if root not in allowed_roots:+ raise ValueError("Skill root not in current scope")++ # construct and validate path (prevent directory traversal)+ root_abs = os.path.abspath(root)+ skill_path = os.path.abspath(os.path.join(root, rel_path))++ # security check: ensure skill_path is within root+ if not skill_path.startswith(root_abs + os.sep) and skill_path != root_abs:+ raise ValueError("Invalid path: directory traversal detected")++ if not os.path.isdir(skill_path):+ raise FileNotFoundError("Skill directory not found")++ # delete directory+ files.delete_dir(skill_path)++ # clean up activation map+ activation_file = _get_activation_file(project_name, profile_name)+ activation_map = _load_activation_map(activation_file)+ activation_map.pop(skill_id, None)+ _write_activation_map(activation_file, activation_map)+++def filter_enabled_skills(skills: List[Skill], agent: Agent|None=None) -> List[Skill]:+ """Filter skills based on activation status."""+ if not skills:+ return skills++ roots = get_skill_roots(agent)+ if not roots:+ return skills++ # sort by path length (longest first) for proper matching+ roots.sort(key=len, reverse=True)++ # cache activation files to avoid repeated reads+ activation_cache: Dict[str, Dict[str, bool]] = {}++ enabled_skills: List[Skill] = []+ for skill in skills:+ # find matching root+ skill_root = None+ for root in roots:+ try:+ Path(str(skill.path)).relative_to(Path(root))+ skill_root = root+ break+ except Exception:+ continue++ if not skill_root:+ # skill not in any known root, include by default+ enabled_skills.append(skill)+ continue++ # determine which activation file to use for this root+ # note: we use global scope here since agent context doesn't map cleanly to project/profile+ activation_file = _get_activation_file(None, None)++ if activation_file not in activation_cache:+ activation_cache[activation_file] = _load_activation_map(activation_file)++ activation_map = activation_cache[activation_file]++ # check activation+ rel_path = os.path.relpath(str(skill.path), skill_root).replace("\\", "/")+ skill_id = f"{skill_root}:{rel_path}"++ if activation_map.get(skill_id, True):+ enabled_skills.append(skill)++ return enabled_skillsdef find_skill(@@ -415,15 +680,3 @@ def validate_skill_md(skill_md_path: Path) -> List[str]:return ["Unable to parse SKILL.md frontmatter"]return validate_skill(skill)--def safe_path_within_dir(base_dir: Path, rel_path: str) -> Path:- """- Resolve rel_path inside base_dir, preventing directory traversal.- """- base = base_dir.resolve()- candidate = (base / rel_path).resolve()- if os.path.commonpath([str(candidate), str(base)]) != str(base):- raise ValueError("Path escapes skill directory")- return candidate--diff --git a/python/tools/skills_tool.py b/python/tools/skills_tool.pyindex 2463e9b9d..f5f225e58 100644--- a/python/tools/skills_tool.py+++ b/python/tools/skills_tool.py@@ -58,8 +58,9 @@ class SkillsTool(Tool):def _list(self) -> str:skills = skills_helper.list_skills(- include_content=False,agent=self.agent,+ include_content=False,+ enabled_only=True,)if not skills:return "No skills found."diff --git a/webui/components/settings/skills/list.html b/webui/components/settings/skills/list.htmlnew file mode 100644index 000000000..30f4499ff--- /dev/null+++ b/webui/components/settings/skills/list.html@@ -0,0 +1,186 @@+<html>+<head>+ <title>List Skills</title>+ <script type="module">+ import { store } from "/components/settings/skills/skills-list-store.js";+ </script>+</head>+<body>+ <div x-data>+ <template x-if="$store.skillsListStore">+ <div x-init="$store.skillsListStore.init()" x-destroy="$store.skillsListStore.onClose()">++ <div class="section-title">List Skills</div>+ <div class="section-description">+ Browse skills across global and project scopes. Duplicates are shown individually.+ </div>++ <div class="skills-list-controls">+ <div class="field">+ <div class="field-label">+ <div class="field-title">Project scope</div>+ <div class="field-description">+ Includes global skills plus the selected project.+ </div>+ </div>+ <div class="field-control">+ <select x-model="$store.skillsListStore.projectName"+ @change="$store.skillsListStore.loadSkills()">+ <option value="">No project</option>+ <template x-for="project in $store.skillsListStore.projects" :key="project.name">+ <option :value="project.name" x-text="project.title || project.name"></option>+ </template>+ </select>+ </div>+ </div>+ <div class="skills-list-actions">+ <button type="button" class="button confirm" title="Refresh"+ @click="$store.skillsListStore.loadSkills()"+ :disabled="$store.skillsListStore.loading">+ <span class="icon material-symbols-outlined">refresh</span> Refresh+ </button>+ </div>+ </div>++ <div x-show="$store.skillsListStore.loading" class="loading">+ <span>Loading skills...</span>+ </div>++ <div x-show="$store.skillsListStore.error" class="error">+ <span x-text="$store.skillsListStore.error"></span>+ </div>++ <template+ x-if="!$store.skillsListStore.loading && !$store.skillsListStore.error && $store.skillsListStore.skills.length === 0">+ <div class="skills-empty">No skills found.</div>+ </template>++ <div class="skills-list">+ <template x-for="skill in $store.skillsListStore.skills" :key="skill.skill_id">+ <div class="skill-card">+ <div class="skill-header">+ <div class="skill-title" x-text="skill.name || '(unnamed skill)'"></div>+ <div class="skill-actions">+ <template x-if="skill.enabled">+ <button type="button" class="button cancel" title="Disable" style="width:9em"+ @click="$store.skillsListStore.toggleSkill(skill, false)">+ <span class="icon material-symbols-outlined">close</span> Disable+ </button>+ </template>+ <template x-if="!skill.enabled">+ <button type="button" class="button confirm" title="Enable" style="width:9em"+ @click="$store.skillsListStore.toggleSkill(skill, true)">+ <span class="icon material-symbols-outlined">play_arrow</span> Enable+ </button>+ </template>+ <button type="button" class="button confirm" title="Open in browser"+ @click="$store.skillsListStore.openSkill(skill)">+ <span class="icon material-symbols-outlined">folder_open</span> Open+ </button>+ <button type="button" class="button cancel icon-button" title="Delete"+ @click="$confirmClick($event, () => $store.skillsListStore.deleteSkill(skill))">+ <span class="icon material-symbols-outlined">delete</span>+ </button>+ </div>+ </div>+ <div class="skill-description" x-text="skill.description || 'No description provided.'"></div>+ <div class="skill-location">+ <span>Location:</span>+ <code x-text="skill.location"></code>+ </div>+ </div>+ </template>+ </div>++ </div>+ </template>+ </div>++ <style>+ .skills-list-controls {+ display: flex;+ align-items: flex-end;+ justify-content: space-between;+ gap: 1rem;+ flex-wrap: wrap;+ }++ .skills-list-actions {+ margin-left: auto;+ }++ .skills-list {+ margin-top: 1rem;+ }++ .skill-card {+ border: 1px solid var(--color-border);+ border-radius: 4px;+ padding: 0.75rem;+ margin-top: 0.75rem;+ background: var(--color-bg-primary);+ }++ .skill-header {+ display: flex;+ align-items: flex-start;+ justify-content: space-between;+ gap: 1rem;+ flex-wrap: wrap;+ }++ .skill-title {+ font-weight: 600;+ font-size: 1rem;+ }++ .skill-actions {+ display: flex;+ align-items: center;+ gap: 0.5rem;+ padding-bottom: var(--spacing-sm);+ flex-wrap: wrap;+ }++ .skill-description {+ margin-top: 0.35rem;+ color: var(--color-text-secondary);+ }++ .skill-location {+ margin-top: 0.35rem;+ font-size: 0.85rem;+ color: var(--color-text-secondary);+ display: flex;+ gap: 0.5rem;+ align-items: center;+ flex-wrap: wrap;+ }++ .skills-empty {+ margin-top: 1rem;+ padding: 0.75rem;+ border: 1px dashed var(--color-border);+ border-radius: 4px;+ text-align: center;+ color: var(--color-text-secondary);+ }++ .loading {+ width: 100%;+ text-align: center;+ margin-top: 1rem;+ margin-bottom: 1rem;+ color: var(--color-secondary);+ }++ .error {+ color: var(--color-error);+ margin: 0.5rem 0;+ padding: 0.5rem;+ background: var(--color-error-bg);+ border-radius: 4px;+ }+ </style>+</body>+</html>diff --git a/webui/components/settings/skills/skills-list-store.js b/webui/components/settings/skills/skills-list-store.jsnew file mode 100644index 000000000..eca605db7--- /dev/null+++ b/webui/components/settings/skills/skills-list-store.js@@ -0,0 +1,157 @@+import { createStore } from "/js/AlpineStore.js";+import { store as fileBrowserStore } from "/components/modals/file-browser/file-browser-store.js";+import { store as settingsStore } from "/components/settings/settings-store.js";+import { store as chatsStore } from "/components/sidebar/chats/chats-store.js";++const fetchApi = globalThis.fetchApi;++const model = {+ loading: false,+ error: "",+ skills: [],+ projects: [],+ projectName: "",+ profileName: "",++ async init() {+ this.resetState();+ await this.loadProjects();+ this.setDefaultProject();+ await this.loadSkills();+ },++ resetState() {+ this.loading = false;+ this.error = "";+ this.skills = [];+ this.projects = [];+ this.projectName = "";+ this.profileName = "";+ },++ onClose() {+ this.resetState();+ },++ setDefaultProject() {+ if (this.projectName) return;+ const active = chatsStore?.selectedContext?.project?.name;+ if (active) {+ this.projectName = active;+ }+ },++ refreshProfileName() {+ this.profileName = settingsStore?.settings?.agent_profile || "";+ },++ async loadProjects() {+ try {+ const response = await fetchApi("/projects", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({ action: "list" }),+ });+ const data = await response.json().catch(() => ({}));+ this.projects = data.ok ? (data.data || []) : [];+ } catch (e) {+ console.error("Failed to load projects:", e);+ this.projects = [];+ }+ },++ async loadSkills() {+ this.refreshProfileName();+ try {+ this.loading = true;+ this.error = "";+ const response = await fetchApi("/skills", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({+ action: "list",+ project_name: this.projectName || null,+ profile_name: this.profileName || null,+ }),+ });+ const result = await response.json().catch(() => ({}));+ if (!result.ok) {+ this.error = result.error || "Failed to load skills";+ this.skills = [];+ return;+ }+ this.skills = Array.isArray(result.data) ? result.data : [];+ } catch (e) {+ this.error = e?.message || "Failed to load skills";+ this.skills = [];+ } finally {+ this.loading = false;+ }+ },++ async toggleSkill(skill, enabled) {+ if (!skill) return;+ const previous = skill.enabled;+ skill.enabled = enabled;+ try {+ const response = await fetchApi("/skills", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({+ action: "toggle",+ skill_id: skill.skill_id,+ enabled,+ project_name: this.projectName || null,+ profile_name: this.profileName || null,+ }),+ });+ const result = await response.json().catch(() => ({}));+ if (!result.ok) {+ throw new Error(result.error || "Toggle failed");+ }+ } catch (e) {+ skill.enabled = previous;+ const msg = e?.message || "Toggle failed";+ if (window.toastFrontendError) {+ window.toastFrontendError(msg, "Skills");+ }+ }+ },++ async deleteSkill(skill) {+ if (!skill) return;+ try {+ const response = await fetchApi("/skills", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({+ action: "delete",+ skill_id: skill.skill_id,+ project_name: this.projectName || null,+ profile_name: this.profileName || null,+ }),+ });+ const result = await response.json().catch(() => ({}));+ if (!result.ok) {+ throw new Error(result.error || "Delete failed");+ }+ if (window.toastFrontendSuccess) {+ window.toastFrontendSuccess("Skill deleted", "Skills");+ }+ await this.loadSkills();+ } catch (e) {+ const msg = e?.message || "Delete failed";+ if (window.toastFrontendError) {+ window.toastFrontendError(msg, "Skills");+ }+ }+ },++ async openSkill(skill) {+ if (!skill?.location) return;+ await fileBrowserStore.open(skill.location);+ },+};++const store = createStore("skillsListStore", model);+export { store };diff --git a/webui/components/settings/skills/skills-settings.html b/webui/components/settings/skills/skills-settings.htmlindex b295a0fd5..827be211b 100644--- a/webui/components/settings/skills/skills-settings.html+++ b/webui/components/settings/skills/skills-settings.html@@ -9,6 +9,12 @@<div><nav><ul>+ <li>+ <a href="#section-skills-list">+ <img src="/public/skills.svg" alt="Skills" />+ <span>List Skills</span>+ </a>+ </li><li><a href="#section-skills-import"><img src="/public/skills.svg" alt="Skills" />@@ -18,6 +24,10 @@</ul></nav>+ <div id="section-skills-list" class="section">+ <x-component path="settings/skills/list.html"></x-component>+ </div>+<div id="section-skills-import" class="section"><x-component path="settings/skills/import.html"></x-component></div>