source: str

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())