Agent Zero AI framework
rename skills dirs for consistency
3clyp502baac232867b
diff --git a/docs/CONTRIBUTING-SKILLS.md b/docs/CONTRIBUTING-SKILLS.mdindex 8f78704ab..4f3b4add8 100644--- a/docs/CONTRIBUTING-SKILLS.md+++ b/docs/CONTRIBUTING-SKILLS.md@@ -341,9 +341,9 @@ def test_skill_has_required_fields():# Edit usr/skills/custom/my-skill/SKILL.md```-3. **Move to Builtin (for contribution):**+3. **Move to Default (for contribution):**```bash- mv usr/skills/custom/my-skill usr/skills/builtin/my-skill+ mv usr/skills/custom/my-skill usr/skills/default/my-skill```4. **Create a Pull Request:**@@ -433,7 +433,7 @@ my-skills-collection/### Q: Where should I put my skills?-**A:** During development, use `usr/skills/custom/`. For contribution, move to `usr/skills/builtin/`.+**A:** During development, use `usr/skills/custom/`. For contribution, move to `usr/skills/default/`.### Q: How are skills discovered?@@ -441,7 +441,7 @@ my-skills-collection/### Q: Can I use skills from other platforms?-**A:** Yes! The SKILL.md standard is cross-platform. Skills from Claude Code, Cursor, or other compatible platforms can be copied directly to `usr/skills/shared/`.+**A:** Yes! The SKILL.md standard is cross-platform. Skills from Claude Code, Cursor, or other compatible platforms can be copied directly to `usr/skills/custom/`.### Q: How do I update a skill?@@ -455,7 +455,7 @@ my-skills-collection/## Example Skills to Learn From-Check out these well-structured skills in `usr/skills/builtin/`:+Check out these well-structured skills in `usr/skills/default/`:- `brainstorming/` - Requirements exploration workflow- `debugging/` - Systematic debugging methodologydiff --git a/docs/architecture.md b/docs/architecture.mdindex a7882dc7d..07294a0bf 100644--- a/docs/architecture.md+++ b/docs/architecture.md@@ -298,9 +298,8 @@ Your detailed instructions here...#### Directory Structure| Directory | Description ||-----------|-------------|-| `/usr/skills/builtin` | Built-in skills included with Agent Zero |+| `/usr/skills/default` | Default skills included with Agent Zero || `/usr/skills/custom` | Your custom skills (create folders here) |-| `/usr/skills/shared` | Skills shared across agents |#### Adding Skills1. Create folder in `usr/skills/custom` (e.g., `usr/skills/custom/my-skill`)diff --git a/python/api/skills_import.py b/python/api/skills_import.pyindex 4b0ce5238..9059bc653 100644--- a/python/api/skills_import.py+++ b/python/api/skills_import.py@@ -14,7 +14,7 @@ from werkzeug.utils import secure_filenameclass SkillsImport(ApiHandler):"""- Import an external skills pack (.zip) into skills/shared/<namespace>/...+ Import an external skills pack (.zip) into usr/skills/custom/<namespace>/...Performs the actual import (not dry-run)."""@@ -31,9 +31,9 @@ class SkillsImport(ApiHandler):return {"success": False, "error": "No context id provided"}_context = self.use_context(ctxid)- dest = (request.form.get("dest", "shared") or "shared").strip().lower()- if dest not in ("shared", "custom", "project"):- dest = "shared"+ dest = (request.form.get("dest", "custom") or "custom").strip().lower()+ if dest not in ("custom", "project"):+ dest = "custom"conflict = (request.form.get("conflict", "skip") or "skip").strip().lower()if conflict not in ("skip", "overwrite", "rename"):diff --git a/python/api/skills_import_preview.py b/python/api/skills_import_preview.pyindex e12262e73..7a33bf110 100644--- a/python/api/skills_import_preview.py+++ b/python/api/skills_import_preview.py@@ -14,7 +14,7 @@ from werkzeug.utils import secure_filenameclass SkillsImportPreview(ApiHandler):"""- Preview importing an external skills pack (.zip) into skills/shared/<namespace>/...+ Preview importing an external skills pack (.zip) into usr/skills/custom/<namespace>/...Uses dry-run (no copying)."""@@ -31,9 +31,9 @@ class SkillsImportPreview(ApiHandler):return {"success": False, "error": "No context id provided"}_context = self.use_context(ctxid)- dest = (request.form.get("dest", "shared") or "shared").strip().lower()- if dest not in ("shared", "custom", "project"):- dest = "shared"+ dest = (request.form.get("dest", "custom") or "custom").strip().lower()+ if dest not in ("custom", "project"):+ dest = "custom"conflict = (request.form.get("conflict", "skip") or "skip").strip().lower()if conflict not in ("skip", "overwrite", "rename"):diff --git a/python/helpers/memory.py b/python/helpers/memory.pyindex 7087d2f32..e23292c81 100644--- a/python/helpers/memory.py+++ b/python/helpers/memory.py@@ -325,7 +325,7 @@ class Memory:# NOTE: Skills indexing into Memory is intentionally disabled for now.# If we decide to replace instruments with skills in memory, re-enable this block:- # skills_dirs = ["custom", "builtin", "shared"]+ # skills_dirs = ["custom", "default"]# for skills_subdir in skills_dirs:# skills_path = files.get_abs_path("usr", "skills", skills_subdir)# index = knowledge_import.load_knowledge(diff --git a/python/helpers/migration.py b/python/helpers/migration.pyindex e502aa9a1..f02c79a67 100644--- a/python/helpers/migration.py+++ b/python/helpers/migration.py@@ -37,7 +37,8 @@ def migrate_user_data() -> None:# We use _merge_dir_contents because we want to move the *contents* of default/# into the parent directory, not move the default directory itself._merge_dir_contents("knowledge/default", "knowledge")- _merge_dir_contents("skills/default", "usr/skills")+ _merge_dir_contents("skills/default", "usr/skills/default")+ _merge_dir_contents("skills/builtin", "usr/skills/default")# --- Cleanup -------------------------------------------------------------------@@ -105,6 +106,7 @@ def _cleanup_obsolete() -> None:to_remove = ["knowledge/default","skills/default",+ "skills/builtin","skills","memory"]diff --git a/python/helpers/skills.py b/python/helpers/skills.pyindex cd60ce458..0fa2a5913 100644--- a/python/helpers/skills.py+++ b/python/helpers/skills.py@@ -14,7 +14,7 @@ except Exception: # pragma: no coveryaml = None # type: ignore-SkillSource = Literal["custom", "builtin", "shared", "project", "framework"]+SkillSource = Literal["custom", "default", "project", "framework"]@dataclass(slots=True)@@ -49,7 +49,7 @@ def get_skill_roots(framework_id: Optional[str] = None,) -> List[Tuple[SkillSource, Path]]:base = get_skills_base_dir()- order = order or ["custom", "builtin", "shared"]+ order = order or ["custom", "default"]roots: List[Tuple[SkillSource, Path]] = [(src, base / src) for src in order]# Framework skills take priority when activediff --git a/python/helpers/skills_cli.py b/python/helpers/skills_cli.pyindex 4cd254cae..865b01d92 100644--- a/python/helpers/skills_cli.py+++ b/python/helpers/skills_cli.py@@ -43,9 +43,8 @@ def get_skills_dirs() -> List[Path]:"""Get all skill directories"""base = Path(files.get_abs_path("usr", "skills"))return [- base / "builtin",base / "custom",- base / "shared",+ base / "default",]diff --git a/python/helpers/skills_import.py b/python/helpers/skills_import.pyindex bc405245b..5ac87413a 100644--- a/python/helpers/skills_import.py+++ b/python/helpers/skills_import.py@@ -14,7 +14,7 @@ from python.helpers.skills import discover_skill_md_filesConflictPolicy = Literal["skip", "overwrite", "rename"]-DestSubdir = Literal["shared", "custom", "project"]+DestSubdir = Literal["custom", "project"]# Project skills folder name (inside .a0proj)PROJECT_SKILLS_DIR = "skills"@@ -180,7 +180,7 @@ def get_project_skills_folder(project_name: str) -> Path:def import_skills(source_path: str,*,- dest_subdir: DestSubdir = "shared",+ dest_subdir: DestSubdir = "custom",namespace: Optional[str] = None,conflict: ConflictPolicy = "skip",dry_run: bool = False,diff --git a/python/tools/skills_tool.py b/python/tools/skills_tool.pyindex 19b61a1fa..ab00f942d 100644--- a/python/tools/skills_tool.py+++ b/python/tools/skills_tool.py@@ -74,7 +74,7 @@ class SkillsTool(Tool):if not skills:return ("No skills found. Expected SKILL.md files under: "- "usr/skills/{custom,builtin,shared} or project .a0proj/skills."+ "usr/skills/{custom,default} or project .a0proj/skills.")# Stable output: sort by namediff --git a/usr/skills/custom/.gitkeep b/usr/skills/custom/.gitkeepnew file mode 100644index 000000000..8b1378917--- /dev/null+++ b/usr/skills/custom/.gitkeep@@ -0,0 +1 @@+diff --git a/usr/skills/builtin/api-development/SKILL.md b/usr/skills/default/api-development/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/api-development/SKILL.mdrename to usr/skills/default/api-development/SKILL.mddiff --git a/usr/skills/builtin/brainstorming/SKILL.md b/usr/skills/default/brainstorming/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/brainstorming/SKILL.mdrename to usr/skills/default/brainstorming/SKILL.mddiff --git a/usr/skills/builtin/code-review/SKILL.md b/usr/skills/default/code-review/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/code-review/SKILL.mdrename to usr/skills/default/code-review/SKILL.mddiff --git a/usr/skills/builtin/create-skill/SKILL.md b/usr/skills/default/create-skill/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/create-skill/SKILL.mdrename to usr/skills/default/create-skill/SKILL.mddiff --git a/usr/skills/builtin/database-design/SKILL.md b/usr/skills/default/database-design/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/database-design/SKILL.mdrename to usr/skills/default/database-design/SKILL.mddiff --git a/usr/skills/builtin/debugging/SKILL.md b/usr/skills/default/debugging/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/debugging/SKILL.mdrename to usr/skills/default/debugging/SKILL.mddiff --git a/usr/skills/builtin/docker-devops/SKILL.md b/usr/skills/default/docker-devops/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/docker-devops/SKILL.mdrename to usr/skills/default/docker-devops/SKILL.mddiff --git a/usr/skills/builtin/git-workflow/SKILL.md b/usr/skills/default/git-workflow/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/git-workflow/SKILL.mdrename to usr/skills/default/git-workflow/SKILL.mddiff --git a/usr/skills/builtin/prompt-engineering/SKILL.md b/usr/skills/default/prompt-engineering/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/prompt-engineering/SKILL.mdrename to usr/skills/default/prompt-engineering/SKILL.mddiff --git a/usr/skills/builtin/security-audit/SKILL.md b/usr/skills/default/security-audit/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/security-audit/SKILL.mdrename to usr/skills/default/security-audit/SKILL.mddiff --git a/usr/skills/builtin/tdd/SKILL.md b/usr/skills/default/tdd/SKILL.mdsimilarity index 100%rename from usr/skills/builtin/tdd/SKILL.mdrename to usr/skills/default/tdd/SKILL.mddiff --git a/usr/skills/frameworks/agent-zero-dev/SKILL.md b/usr/skills/frameworks/agent-zero-dev/SKILL.mdindex b8560b66a..02fea2a88 100644--- a/usr/skills/frameworks/agent-zero-dev/SKILL.md+++ b/usr/skills/frameworks/agent-zero-dev/SKILL.md@@ -53,7 +53,7 @@ Agent Zero Framework Architecture│ ├── api/ # FastAPI endpoints (inherit from ApiHandler)│ └── helpers/ # Utility functions and base classes├── usr/skills/-│ ├── builtin/ # Built-in skills (system)+│ ├── default/ # Default skills (system)│ ├── custom/ # User-created skills│ └── frameworks/ # Multi-phase framework skills├── agents/diff --git a/usr/skills/frameworks/agent-zero-dev/a0dev-create-skill/SKILL.md b/usr/skills/frameworks/agent-zero-dev/a0dev-create-skill/SKILL.mdindex 9692c6ff8..722506e50 100644--- a/usr/skills/frameworks/agent-zero-dev/a0dev-create-skill/SKILL.md+++ b/usr/skills/frameworks/agent-zero-dev/a0dev-create-skill/SKILL.md@@ -20,7 +20,7 @@ Skills are reusable instruction bundles that guide the agent through specific ta```usr/skills/-├── builtin/ # System skills (don't modify)+├── default/ # System skills (don't modify)├── custom/ # Your skills go here│ └── my-skill/│ ├── SKILL.md # Required: Main skill filediff --git a/usr/skills/frameworks/agent-zero-dev/a0dev-quickstart/SKILL.md b/usr/skills/frameworks/agent-zero-dev/a0dev-quickstart/SKILL.mdindex 5170ef998..d3af4dbd2 100644--- a/usr/skills/frameworks/agent-zero-dev/a0dev-quickstart/SKILL.md+++ b/usr/skills/frameworks/agent-zero-dev/a0dev-quickstart/SKILL.md@@ -53,7 +53,7 @@ Agent Zero Framework│ ├── api/ # FastAPI endpoints (inherit from ApiHandler)│ └── helpers/ # Utility functions and base classes├── usr/skills/-│ ├── builtin/ # Built-in skills+│ ├── default/ # Default skills│ ├── custom/ # Your skills go here│ └── frameworks/ # Multi-phase framework skills├── agents/ # Subordinate profilesdiff --git a/usr/skills/frameworks/agent-zero-dev/docs/architecture.md b/usr/skills/frameworks/agent-zero-dev/docs/architecture.mdindex 592973269..902810690 100644--- a/usr/skills/frameworks/agent-zero-dev/docs/architecture.md+++ b/usr/skills/frameworks/agent-zero-dev/docs/architecture.md@@ -168,7 +168,7 @@ Skills follow the SKILL.md standard:```usr/skills/-├── builtin/ # System skills (loaded first)+├── default/ # System skills (loaded first)├── custom/ # User-created skills└── frameworks/ # Multi-phase framework skills```diff --git a/usr/skills/frameworks/agent-zero-dev/docs/quickstart.md b/usr/skills/frameworks/agent-zero-dev/docs/quickstart.mdindex dbae25fd9..b0d9cd90d 100644--- a/usr/skills/frameworks/agent-zero-dev/docs/quickstart.md+++ b/usr/skills/frameworks/agent-zero-dev/docs/quickstart.md@@ -59,5 +59,5 @@ curl "http://localhost:5001/api/data_api?context=test¶m=value"- Read the full [SKILL.md](../SKILL.md) for comprehensive documentation- Explore existing tools in `/a0/python/tools/`-- Check out built-in skills in `/a0/usr/skills/builtin/`+- Check out default skills in `/a0/usr/skills/default/`- Review the Superpowers framework for development workflowsdiff --git a/usr/skills/shared/.gitkeep b/usr/skills/shared/.gitkeepdeleted file mode 100644index e69de29bb..000000000diff --git a/webui/components/projects/project-edit-skills.html b/webui/components/projects/project-edit-skills.htmlindex 87579df2e..cc3cbaf9c 100644--- a/webui/components/projects/project-edit-skills.html+++ b/webui/components/projects/project-edit-skills.html@@ -36,7 +36,7 @@<code x-text="'usr/projects/' + $store.projects.selectedProject.name + '/.a0proj/skills/'"></code></p><p class="skills-note">- Use the global Settings > Skills tab for shared skills available to all projects.+ Use the global Settings > Skills tab for custom skills available to all projects.</p></div></div>diff --git a/webui/components/settings/skills/import.html b/webui/components/settings/skills/import.htmlindex 1c4b1f634..d945d3b4c 100644--- a/webui/components/settings/skills/import.html+++ b/webui/components/settings/skills/import.html@@ -28,7 +28,6 @@<span class="policy-label-text">Destination:</span><select x-model="$store.skillsImportStore.dest" class="policy-dropdown"@change="$store.skillsImportStore.previewImport()">- <option value="shared">Shared (recommended)</option><option value="custom">Custom</option><option value="project">Project</option></select>diff --git a/webui/components/settings/skills/skills-import-store.js b/webui/components/settings/skills/skills-import-store.jsindex c12956196..4e660363d 100644--- a/webui/components/settings/skills/skills-import-store.js+++ b/webui/components/settings/skills/skills-import-store.js@@ -16,7 +16,7 @@ const model = {error: "",skillsFile: null,- dest: "shared", // shared|custom|project+ dest: "custom", // custom|projectnamespace: "",conflict: "skip", // skip|overwrite|renameprojectName: "", // selected project name when dest is "project"@@ -42,7 +42,7 @@ const model = {this.resetState();this.skillsFile = null;this.namespace = "";- this.dest = "shared";+ this.dest = "custom";this.conflict = "skip";this.projectName = "";},