Skip to content

Agent Zero AI framework

rename skills dirs for consistency

3clyp502baac232867b
diff --git a/docs/CONTRIBUTING-SKILLS.md b/docs/CONTRIBUTING-SKILLS.md
index 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 methodology
diff --git a/docs/architecture.md b/docs/architecture.md
index 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 Skills
1. 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.py
index 4b0ce5238..9059bc653 100644
--- a/python/api/skills_import.py
+++ b/python/api/skills_import.py
@@ -14,7 +14,7 @@ from werkzeug.utils import secure_filename
class 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.py
index 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_filename
class 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.py
index 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.py
index 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.py
index cd60ce458..0fa2a5913 100644
--- a/python/helpers/skills.py
+++ b/python/helpers/skills.py
@@ -14,7 +14,7 @@ except Exception: # pragma: no cover
yaml = 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 active
diff --git a/python/helpers/skills_cli.py b/python/helpers/skills_cli.py
index 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.py
index 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_files
ConflictPolicy = 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.py
index 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 name
diff --git a/usr/skills/custom/.gitkeep b/usr/skills/custom/.gitkeep
new file mode 100644
index 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.md
similarity index 100%
rename from usr/skills/builtin/api-development/SKILL.md
rename to usr/skills/default/api-development/SKILL.md
diff --git a/usr/skills/builtin/brainstorming/SKILL.md b/usr/skills/default/brainstorming/SKILL.md
similarity index 100%
rename from usr/skills/builtin/brainstorming/SKILL.md
rename to usr/skills/default/brainstorming/SKILL.md
diff --git a/usr/skills/builtin/code-review/SKILL.md b/usr/skills/default/code-review/SKILL.md
similarity index 100%
rename from usr/skills/builtin/code-review/SKILL.md
rename to usr/skills/default/code-review/SKILL.md
diff --git a/usr/skills/builtin/create-skill/SKILL.md b/usr/skills/default/create-skill/SKILL.md
similarity index 100%
rename from usr/skills/builtin/create-skill/SKILL.md
rename to usr/skills/default/create-skill/SKILL.md
diff --git a/usr/skills/builtin/database-design/SKILL.md b/usr/skills/default/database-design/SKILL.md
similarity index 100%
rename from usr/skills/builtin/database-design/SKILL.md
rename to usr/skills/default/database-design/SKILL.md
diff --git a/usr/skills/builtin/debugging/SKILL.md b/usr/skills/default/debugging/SKILL.md
similarity index 100%
rename from usr/skills/builtin/debugging/SKILL.md
rename to usr/skills/default/debugging/SKILL.md
diff --git a/usr/skills/builtin/docker-devops/SKILL.md b/usr/skills/default/docker-devops/SKILL.md
similarity index 100%
rename from usr/skills/builtin/docker-devops/SKILL.md
rename to usr/skills/default/docker-devops/SKILL.md
diff --git a/usr/skills/builtin/git-workflow/SKILL.md b/usr/skills/default/git-workflow/SKILL.md
similarity index 100%
rename from usr/skills/builtin/git-workflow/SKILL.md
rename to usr/skills/default/git-workflow/SKILL.md
diff --git a/usr/skills/builtin/prompt-engineering/SKILL.md b/usr/skills/default/prompt-engineering/SKILL.md
similarity index 100%
rename from usr/skills/builtin/prompt-engineering/SKILL.md
rename to usr/skills/default/prompt-engineering/SKILL.md
diff --git a/usr/skills/builtin/security-audit/SKILL.md b/usr/skills/default/security-audit/SKILL.md
similarity index 100%
rename from usr/skills/builtin/security-audit/SKILL.md
rename to usr/skills/default/security-audit/SKILL.md
diff --git a/usr/skills/builtin/tdd/SKILL.md b/usr/skills/default/tdd/SKILL.md
similarity index 100%
rename from usr/skills/builtin/tdd/SKILL.md
rename to usr/skills/default/tdd/SKILL.md
diff --git a/usr/skills/frameworks/agent-zero-dev/SKILL.md b/usr/skills/frameworks/agent-zero-dev/SKILL.md
index 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.md
index 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 file
diff --git a/usr/skills/frameworks/agent-zero-dev/a0dev-quickstart/SKILL.md b/usr/skills/frameworks/agent-zero-dev/a0dev-quickstart/SKILL.md
index 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 profiles
diff --git a/usr/skills/frameworks/agent-zero-dev/docs/architecture.md b/usr/skills/frameworks/agent-zero-dev/docs/architecture.md
index 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.md
index 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&param=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 workflows
diff --git a/usr/skills/shared/.gitkeep b/usr/skills/shared/.gitkeep
deleted file mode 100644
index e69de29bb..000000000
diff --git a/webui/components/projects/project-edit-skills.html b/webui/components/projects/project-edit-skills.html
index 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 &gt; Skills tab for shared skills available to all projects.
+ Use the global Settings &gt; 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.html
index 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.js
index 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|project
namespace: "",
conflict: "skip", // skip|overwrite|rename
projectName: "", // 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 = "";
},