"""Skill loader for CLI commands.

This module provides filesystem-based skill loading for CLI operations (list, create, info). It wraps the prebuilt middleware functionality from deepagents.middleware.skills and adapts it for direct filesystem access needed by CLI commands.

For middleware usage within agents, use deepagents.middleware.skills.SkillsMiddleware directly. """

from future import annotations

from pathlib import Path

from deepagents.backends.filesystem import FilesystemBackend from deepagents.middleware.skills import SkillMetadata from deepagents.middleware.skills import _list_skills as list_skills_from_backend

class ExtendedSkillMetadata(SkillMetadata): """Extended skill metadata for CLI display, adds source tracking."""

source: str

Re-export for CLI commands

all = ["SkillMetadata", "list_skills"]

def list_skills( *, user_skills_dir: Path | None = None, project_skills_dir: Path | None = None ) -> list[ExtendedSkillMetadata]: """List skills from user and/or project directories.

This is a CLI-specific wrapper around the prebuilt middleware's skill loading
functionality. It uses FilesystemBackend to load skills from local directories.

When both directories are provided, project skills with the same name as
user skills will override them (project skills take precedence).

Args:
    user_skills_dir: Path to the user-level skills directory.
    project_skills_dir: Path to the project-level skills directory.

Returns:
    Merged list of skill metadata from both sources, with project skills
    taking precedence over user skills when names conflict.
"""
all_skills: dict[str, ExtendedSkillMetadata] = {}

# Load user skills first (foundation)
if user_skills_dir and user_skills_dir.exists():
    user_backend = FilesystemBackend(root_dir=str(user_skills_dir))
    user_skills = list_skills_from_backend(backend=user_backend, source_path=".")
    for skill in user_skills:
        # Add source field for CLI display
        extended_skill: ExtendedSkillMetadata = {**skill, "source": "user"}
        all_skills[skill["name"]] = extended_skill

# Load project skills second (override/augment)
if project_skills_dir and project_skills_dir.exists():
    project_backend = FilesystemBackend(root_dir=str(project_skills_dir))
    project_skills = list_skills_from_backend(backend=project_backend, source_path=".")
    for skill in project_skills:
        # Add source field for CLI display
        extended_skill: ExtendedSkillMetadata = {**skill, "source": "project"}
        all_skills[skill["name"]] = extended_skill

return list(all_skills.values())