llms-py 3.0.23__py3-none-any.whl → 3.0.24__py3-none-any.whl

llms/extensions/skills/README.md

@@ -33,14 +33,21 @@ Access the skills panel by clicking the **Skills** icon in the top toolbar. The
 
 ### Skill Groups
 
-Skills are organized into groups based on their source:
+Skills are organized into groups based on their source location. Skills are discovered from these directories in order:
 
-| Group | Description | Editable |
-|-------|-------------|----------|
-| `~/.llms/.agents` | Your personal skills collection | ✓ Yes |
-| Built-in | Skills bundled with the extension | ✗ No |
+| Group | Location | Description | Editable |
+|-------|----------|-------------|----------|
+| Project (Agent) | `.agent/skills/` | Skills local to the current project | ✓ Yes |
+| Project (Claude) | `.claude/skills/` | Claude-format skills in the current project | ✓ Yes |
+| User (Agent) | `~/.llms/.agents/skills/` | Your personal skills collection | ✓ Yes |
+| User (Claude) | `~/.claude/skills/` | Claude-format skills in your home directory | ✓ Yes |
+| Built-in | Extension directory | Skills bundled with the extension | ✗ No |
 
-Your personal skills (`~/.llms/.agents`) are fully editable. Built-in skills provide reference implementations you can learn from.
+**Project-level skills** (`.agent/` and `.claude/`) are specific to the workspace you're working in. They're ideal for project-specific workflows, coding standards, or team conventions.
+
+**User-level skills** (`~/.llms/.agents/` and `~/.claude/`) are available across all projects. Use these for personal workflows and preferences.
+
+Both `.agent` and `.claude` directory formats are supported for compatibility with different tooling conventions.
 
 ### Selecting Skills for a Conversation
 

llms/extensions/skills/__init__.py

@@ -21,6 +21,9 @@ g_home_skills = None
 # }
 g_available_skills = []
 
+LLMS_HOME_SKILLS = "~/.llms/.agent/skills"
+LLMS_LOCAL_SKILLS = ".agent/skills"
+
 
 def is_safe_path(base_path: str, requested_path: str) -> bool:
     """Check if the requested path is safely within the base path."""
@@ -132,10 +135,12 @@ def install(ctx):
     if os.path.exists(os.path.join(".claude", "skills")):
         skill_roots[".claude/skills"] = os.path.join(".claude", "skills")
 
-    skill_roots["~/.llms/.agents"] = home_skills
+    skill_roots[LLMS_HOME_SKILLS] = home_skills
 
-    if os.path.exists(os.path.join(".agent", "skills")):
-        skill_roots[".agents"] = os.path.join(".agent", "skills")
+    local_skills = os.path.join(".agent", "skills")
+    if os.path.exists(local_skills):
+        local_skills = str(Path(local_skills).resolve())
+        skill_roots[LLMS_LOCAL_SKILLS] = local_skills
 
     g_skills = {}
     for group, root in skill_roots.items():
@@ -237,7 +242,7 @@ def install(ctx):
                 skill_props = props.to_dict()
                 skill_props.update(
                     {
-                        "group": "~/.llms/.agents",
+                        "group": LLMS_HOME_SKILLS,
                         "location": str(skill_dir),
                         "files": files,
                     }
@@ -303,9 +308,9 @@ def install(ctx):
 
         location = skill_info.get("location")
 
-        # Only allow modifications to skills in home directory
-        if not is_safe_path(home_skills, location):
-            raise Exception("Cannot modify skills outside of home directory")
+        # Only allow modifications to skills in home or local .agent directory
+        if not is_safe_path(home_skills, location) and not (local_skills and is_safe_path(local_skills, location)):
+            raise Exception("Cannot modify skills outside of allowed directories")
 
         full_path = os.path.join(location, file_path)
 
@@ -319,7 +324,7 @@ def install(ctx):
                 f.write(content)
 
             # Reload skill metadata
-            group = skill_info.get("group", "~/.llms/.agents")
+            group = skill_info.get("group", LLMS_HOME_SKILLS)
             updated_skill = reload_skill(name, location, group)
 
             return aiohttp.web.json_response({"path": file_path, "skill": updated_skill})
@@ -342,9 +347,9 @@ def install(ctx):
 
         location = skill_info.get("location")
 
-        # Only allow modifications to skills in home directory
-        if not is_safe_path(home_skills, location):
-            raise Exception("Cannot modify skills outside of home directory")
+        # Only allow modifications to skills in home or local .agent directory
+        if not is_safe_path(home_skills, location) and not (local_skills and is_safe_path(local_skills, location)):
+            raise Exception("Cannot modify skills outside of allowed directories")
 
         full_path = os.path.join(location, file_path)
 
@@ -371,7 +376,7 @@ def install(ctx):
                     break
 
             # Reload skill metadata
-            group = skill_info.get("group", "~/.llms/.agents")
+            group = skill_info.get("group", LLMS_HOME_SKILLS)
             updated_skill = reload_skill(name, location, group)
 
             return aiohttp.web.json_response({"path": file_path, "skill": updated_skill})
@@ -433,7 +438,7 @@ def install(ctx):
                 skill_props = props.to_dict()
                 skill_props.update(
                     {
-                        "group": "~/.llms/.agents",
+                        "group": LLMS_HOME_SKILLS,
                         "location": str(skill_dir_path),
                         "files": files,
                     }
@@ -467,9 +472,9 @@ def install(ctx):
             else:
                 raise Exception(f"Skill '{name}' not found")
 
-        # Only allow deletion of skills in home directory
-        if not is_safe_path(home_skills, location):
-            raise Exception("Cannot delete skills outside of home directory")
+        # Only allow deletion of skills in home or local .agent directory
+        if not is_safe_path(home_skills, location) and not (local_skills and is_safe_path(local_skills, location)):
+            raise Exception("Cannot delete skills outside of allowed directories")
 
         try:
             if os.path.exists(location):

llms/extensions/skills/ui/index.mjs

@@ -3,6 +3,9 @@ import { leftPart } from "@servicestack/client"
 
 let ext
 
+const LLMS_HOME_SKILLS = "~/.llms/.agent/skills"
+const LLMS_LOCAL_SKILLS = ".agent/skills"
+
 const SkillSelector = {
     template: `
         <div class="px-4 py-4 bg-gray-50 dark:bg-gray-800 border-b border-gray-200 dark:border-gray-700 max-h-[80vh] overflow-y-auto">
@@ -119,10 +122,10 @@ const SkillSelector = {
                 skills
             }))
 
-            // Sort groups: writable (~/.llms/.agents) first, then alphabetically
+            // Sort groups: writable (~/.llms/.agent/skills,.agent/skills) first, then alphabetically
             definedGroups.sort((a, b) => {
-                const aEditable = a.name === '~/.llms/.agents'
-                const bEditable = b.name === '~/.llms/.agents'
+                const aEditable = a.name === LLMS_HOME_SKILLS || a.name === LLMS_LOCAL_SKILLS
+                const bEditable = b.name === LLMS_HOME_SKILLS || b.name === LLMS_LOCAL_SKILLS
                 if (aEditable !== bEditable) return aEditable ? -1 : 1
                 return a.name.localeCompare(b.name)
             })
@@ -158,6 +161,10 @@ const SkillSelector = {
                     onlySkills = onlySkills.filter(s => s !== name)
                 } else {
                     onlySkills = [...onlySkills, name]
+                    // If has all skills set to 'All' (null)
+                    if (onlySkills.length === availableSkills.value.length) {
+                        onlySkills = null
+                    }
                 }
             }
 
@@ -395,8 +402,8 @@ const SkillPage = {
                 grouped[group].push(skill)
             })
             return Object.entries(grouped).sort((a, b) => {
-                const aEditable = a[0] === '~/.llms/.agents'
-                const bEditable = b[0] === '~/.llms/.agents'
+                const aEditable = a[0] === LLMS_HOME_SKILLS || a[0] === LLMS_LOCAL_SKILLS
+                const bEditable = b[0] === LLMS_HOME_SKILLS || b[0] === LLMS_LOCAL_SKILLS
                 if (aEditable !== bEditable) return aEditable ? -1 : 1
                 return a[0].localeCompare(b[0])
             }).map(([name, skills]) => ({ name, skills: skills.sort((a, b) => a.name.localeCompare(b.name)) }))
@@ -419,8 +426,8 @@ const SkillPage = {
             return tree.sort((a, b) => { if (a.isFile !== b.isFile) return a.isFile ? 1 : -1; return a.name.localeCompare(b.name) })
         }
         const hasUnsavedChanges = computed(() => isEditing.value && editContent.value !== fileContent.value)
-        function isGroupEditable(groupName) { return groupName === '~/.llms/.agents' }
-        function isEditable(skill) { return skill?.group === '~/.llms/.agents' }
+        function isGroupEditable(groupName) { return groupName === LLMS_HOME_SKILLS || groupName === LLMS_LOCAL_SKILLS }
+        function isEditable(skill) { return skill?.group === LLMS_HOME_SKILLS || skill?.group === LLMS_LOCAL_SKILLS }
         function isSkillExpanded(name) { return !!expandedSkills.value[name] }
         function toggleSkillExpand(skill) {
             expandedSkills.value[skill.name] = !expandedSkills.value[skill.name]
@@ -579,7 +586,7 @@ const SkillStore = {
         <div class="h-full flex flex-col">
             <div class="px-4 py-3 bg-gray-50 dark:bg-gray-800 border-b border-gray-200 dark:border-gray-700 flex items-center justify-between flex-shrink-0">
                 <div>
-                    <h1 class="text-xl font-bold text-gray-900 dark:text-gray-100">Skill Store</h1>
+                    <h1 class="text-xl font-bold text-gray-900 dark:text-gray-100">Discover Skills</h1>
                     <p class="text-sm text-gray-500 dark:text-gray-400">{{ total.toLocaleString() }} skills available</p>
                 </div>
                 <div class="flex items-center gap-2">

llms/main.py

@@ -57,7 +57,7 @@ try:
 except ImportError:
     HAS_PIL = False
 
-VERSION = "3.0.23"
+VERSION = "3.0.24"
 _ROOT = None
 DEBUG = os.getenv("DEBUG") == "1"
 MOCK = os.getenv("MOCK") == "1"

llms/ui/ai.mjs

@@ -6,7 +6,7 @@ const headers = { 'Accept': 'application/json' }
 const prefsKey = 'llms.prefs'
 
 export const o = {
-    version: '3.0.23',
+    version: '3.0.24',
     base,
     prefsKey,
     welcome: 'Welcome to llms.py',

{llms_py-3.0.23.dist-info → llms_py-3.0.24.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llms-py
-Version: 3.0.23
+Version: 3.0.24
 Summary: A lightweight CLI tool and OpenAI-compatible server for querying multiple Large Language Model (LLM) providers
 Home-page: https://github.com/ServiceStack/llms
 Author: ServiceStack

{llms_py-3.0.23.dist-info → llms_py-3.0.24.dist-info}/RECORD

@@ -3,7 +3,7 @@ llms/__main__.py,sha256=hrBulHIt3lmPm1BCyAEVtB6DQ0Hvc3gnIddhHCmJasg,151
 llms/db.py,sha256=oozp5I5lECVO8oZEFwcZl3ES5mARqWeR1BkoqG5kSqM,11687
 llms/index.html,sha256=nGk1Djtn9p7l6LuKp4Kg0JIB9fCzxtTWXFfmDb4ggpc,1658
 llms/llms.json,sha256=xeIOuraZKs4CwSJ8R2aDAOClLqx6rdEN68O6s51_7cA,11824
-llms/main.py,sha256=El7gujZ4y68Ytwih6II335V0WqzKnYj4idlN9QxpygI,184270
+llms/main.py,sha256=MBRi98pE7MZ70Iw45vMVEHqeRn6WH4oJFAY5gvjnhFM,184270
 llms/providers-extra.json,sha256=_6DmGBiQY9LM6_Y0zOiObYn7ba4g3akSNQfmHcYlENc,11101
 llms/providers.json,sha256=yls3OUqPIBLSf2rk0xgwUHKkvd-8drGq4JW7w49rEws,299324
 llms/extensions/analytics/ui/index.mjs,sha256=m1XwaqYCLwK267JAUCAltkN_nOXep0GxfpvGNS5i4_w,69547
@@ -146,14 +146,14 @@ llms/extensions/providers/openai.py,sha256=n1jTXkWPrboTazCW0FX3zYYaOlsW44rQpIfgK
 llms/extensions/providers/openrouter.py,sha256=9V1NSZJblku_lfsDY8Fantr5QFzkp3A0hXFDCYucShM,3344
 llms/extensions/providers/zai.py,sha256=WPJlDxmnjuhxlgWhUXw2MYqgEKYfy14wVQbpQyMMlbU,7736
 llms/extensions/skills/LICENSE,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
-llms/extensions/skills/README.md,sha256=lOkqltm6F9tHlJGCPdyvXsoNSPT-JwqMGaHPnI5mNbE,9744
-llms/extensions/skills/__init__.py,sha256=5gUgethVQuuzueMxr37DIHwy7ROhBrpMU5D8W55ITpo,16837
+llms/extensions/skills/README.md,sha256=wawmpeyiJFw9G8qzCZ3CiKamt47k6fO680gFX9wuOGs,10471
+llms/extensions/skills/__init__.py,sha256=DK4UECLKOmdL5_gz7NeKeZuuo7j5tpJzmGEcczkz3N4,17244
 llms/extensions/skills/errors.py,sha256=V4DTFNtzVADDlZ0g7RmoxZRFeG01oaG3zzaPAVdtkfQ,572
 llms/extensions/skills/installer.py,sha256=GfNYRK6LbYSZtIOesQ_fQvjtBsiZC9sTXLVuUbrrdLI,12751
 llms/extensions/skills/models.py,sha256=xmRfz8BMeOdzZXhW6MYFjkOVHOKD6bMDynId8aysans,1461
 llms/extensions/skills/parser.py,sha256=Mb4NOtoY3Ip4Nng8ixb26oE8U_Sp5CI3n3l_qxbg1UM,5500
 llms/extensions/skills/validator.py,sha256=te49hTfIPJWcMcLLCApSJ2Ru3lrqVF8ayDXtPEZF9sU,5154
-llms/extensions/skills/ui/index.mjs,sha256=iaMvytaFXTnxSRa2XnE-4IilvjL7JVjn7stv4uRg5Sk,62989
+llms/extensions/skills/ui/index.mjs,sha256=U4oeqSGM2Q4hzIIK0sAFqi9AtZvmyUm5SdBYT2i-cMY,63499
 llms/extensions/skills/ui/data/skills-top-5000.json,sha256=e8fUF_NQSUZRK0rGRUqBFecW5JEX6QO6H_P3WqTBBQ4,540056
 llms/extensions/skills/ui/skills/create-plan/SKILL.md,sha256=ZAtiM2qPHcc8Z3Ongl1NgX5ythITPwyvcIqisgqWrGA,2493
 llms/extensions/skills/ui/skills/skill-creator/LICENSE.txt,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
@@ -170,7 +170,7 @@ llms/extensions/system_prompts/ui/prompts.json,sha256=t5DD3bird-87wFa4OlW-bC2wdo
 llms/extensions/tools/__init__.py,sha256=PRZe0QMfsOymJ3jTqO0VFppNEWI4f2bYSOImK_YrGQM,2036
 llms/extensions/tools/ui/index.mjs,sha256=1TgCn74oX_rUAhxO8w54HlIgNkHnI5ma-GCqXp-qYVY,39434
 llms/ui/App.mjs,sha256=CoUzO9mV__-jV19NKHYIbwHsjWMnO11jyNSbnJhe1gQ,7486
-llms/ui/ai.mjs,sha256=99DB9vaecnKlSJqENN2HAcRoAMOjOx3E6z3nHRely0k,6541
+llms/ui/ai.mjs,sha256=SMAvpE5QzcoQvCNaoOptjZX8k8P3kH4L4yEkDTMfP-E,6541
 llms/ui/app.css,sha256=SVVzmFhTd0chuGq5yhv3FjgNudgo6WXlM2fnb-csK4c,190220
 llms/ui/ctx.mjs,sha256=4x-LTmofhf6OvLThSlDSTQOsLkzyBFOEMRGIOLHszqs,14974
 llms/ui/fav.svg,sha256=_R6MFeXl6wBFT0lqcUxYQIDWgm246YH_3hSTW0oO8qw,734
@@ -196,9 +196,9 @@ llms/ui/modules/model-selector.mjs,sha256=6U4rAZ7vmQELFRQGWk4YEtq02v3lyHdMq6yUOp
 llms/ui/modules/chat/ChatBody.mjs,sha256=jusiYUxz8NoN6iYCrEayYW5t2wdOx0So79aLxjk7J9c,58187
 llms/ui/modules/chat/SettingsDialog.mjs,sha256=HMBJTwrapKrRIAstIIqp0QlJL5O-ho4hzgvfagPfsX8,19930
 llms/ui/modules/chat/index.mjs,sha256=nS_L6G1RSuCybgnA6n-q8Sn3OeSbQWL2iW3-zCIFqJk,39548
-llms_py-3.0.23.dist-info/licenses/LICENSE,sha256=bus9cuAOWeYqBk2OuhSABVV1P4z7hgrEFISpyda_H5w,1532
-llms_py-3.0.23.dist-info/METADATA,sha256=p8iwgMvOIM6JjJX645DBxZYjjdFvq-LGXHo1CJgfRdU,2195
-llms_py-3.0.23.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-llms_py-3.0.23.dist-info/entry_points.txt,sha256=WswyE7PfnkZMIxboC-MS6flBD6wm-CYU7JSUnMhqMfM,40
-llms_py-3.0.23.dist-info/top_level.txt,sha256=gC7hk9BKSeog8gyg-EM_g2gxm1mKHwFRfK-10BxOsa4,5
-llms_py-3.0.23.dist-info/RECORD,,
+llms_py-3.0.24.dist-info/licenses/LICENSE,sha256=bus9cuAOWeYqBk2OuhSABVV1P4z7hgrEFISpyda_H5w,1532
+llms_py-3.0.24.dist-info/METADATA,sha256=DIZBWhv5icDwZzyHFqY9up_pq-9Om3JiNpW4GNYpjfA,2195
+llms_py-3.0.24.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+llms_py-3.0.24.dist-info/entry_points.txt,sha256=WswyE7PfnkZMIxboC-MS6flBD6wm-CYU7JSUnMhqMfM,40
+llms_py-3.0.24.dist-info/top_level.txt,sha256=gC7hk9BKSeog8gyg-EM_g2gxm1mKHwFRfK-10BxOsa4,5
+llms_py-3.0.24.dist-info/RECORD,,