skills

Class info

Classes

Name	Children	Inherits
SkillsManager llmling_agent.skills.manager Manages skills discovery and distributes skills provider to agents.		object

🛈 DocStrings

Skills package for Claude Code Skills support.

SkillsManager

Manages skills discovery and distributes skills provider to agents.

Source code in src/llmling_agent/skills/manager.py

class SkillsManager:
    """Manages skills discovery and distributes skills provider to agents."""

    def __init__(
        self,
        name: str = "skills",
        owner: str | None = None,
        skills_dirs: list[JoinablePathLike] | None = None,
    ) -> None:
        """Initialize the skills manager.

        Args:
            name: Name for this manager
            owner: Owner of this manager
            skills_dirs: Directories to search for skills
        """
        self.name = name
        self.owner = owner
        self.registry = SkillsRegistry(skills_dirs)
        self.provider = SkillsResourceProvider(self.registry, name=name, owner=owner)
        self.exit_stack = AsyncExitStack()
        self._initialized = False

    def __repr__(self) -> str:
        skill_count = len(self.registry.list_items()) if self._initialized else "?"
        return f"SkillsManager(name={self.name!r}, skills={skill_count})"

    async def __aenter__(self) -> Self:
        """Initialize the skills manager."""
        try:
            # Initialize the provider through its async context manager
            await self.exit_stack.enter_async_context(self.provider)
            self._initialized = True
            count = len(self.registry.list_items())
            logger.info("Skills manager initialized", name=self.name, skill_count=count)
        except Exception as e:
            msg = "Failed to initialize skills manager"
            logger.exception(msg, name=self.name, error=e)
            raise
        return self

    async def __aexit__(self, *args: object) -> None:
        """Clean up the skills manager."""
        await self.exit_stack.aclose()

    def get_skills_provider(self) -> SkillsResourceProvider:
        """Get the skills resource provider for agents."""
        return self.provider

    async def refresh_skills(self) -> None:
        """Refresh skills discovery."""
        await self.provider.refresh()
        skill_count = len(self.registry.list_items())
        logger.info("Skills refreshed", name=self.name, skill_count=skill_count)

    def add_skills_directory(self, path: JoinablePathLike) -> None:
        """Add a new skills directory to search."""
        if path not in self.registry.skills_dirs:
            self.registry.skills_dirs.append(UPath(path))
            logger.info("Added skills directory", path=str(path))

__aenter__ async

__aenter__() -> Self

Initialize the skills manager.

Source code in src/llmling_agent/skills/manager.py

async def __aenter__(self) -> Self:
    """Initialize the skills manager."""
    try:
        # Initialize the provider through its async context manager
        await self.exit_stack.enter_async_context(self.provider)
        self._initialized = True
        count = len(self.registry.list_items())
        logger.info("Skills manager initialized", name=self.name, skill_count=count)
    except Exception as e:
        msg = "Failed to initialize skills manager"
        logger.exception(msg, name=self.name, error=e)
        raise
    return self

__aexit__ async

__aexit__(*args: object) -> None

Clean up the skills manager.

Source code in src/llmling_agent/skills/manager.py

async def __aexit__(self, *args: object) -> None:
    """Clean up the skills manager."""
    await self.exit_stack.aclose()

__init__

__init__(
    name: str = "skills",
    owner: str | None = None,
    skills_dirs: list[JoinablePathLike] | None = None,
) -> None

Initialize the skills manager.

Parameters:

Name	Type	Description	Default
name	str	Name for this manager	'skills'
owner	str | None	Owner of this manager	None
skills_dirs	list[JoinablePathLike] | None	Directories to search for skills	None

Source code in src/llmling_agent/skills/manager.py

def __init__(
    self,
    name: str = "skills",
    owner: str | None = None,
    skills_dirs: list[JoinablePathLike] | None = None,
) -> None:
    """Initialize the skills manager.

    Args:
        name: Name for this manager
        owner: Owner of this manager
        skills_dirs: Directories to search for skills
    """
    self.name = name
    self.owner = owner
    self.registry = SkillsRegistry(skills_dirs)
    self.provider = SkillsResourceProvider(self.registry, name=name, owner=owner)
    self.exit_stack = AsyncExitStack()
    self._initialized = False

add_skills_directory

add_skills_directory(path: JoinablePathLike) -> None

Add a new skills directory to search.

Source code in src/llmling_agent/skills/manager.py

def add_skills_directory(self, path: JoinablePathLike) -> None:
    """Add a new skills directory to search."""
    if path not in self.registry.skills_dirs:
        self.registry.skills_dirs.append(UPath(path))
        logger.info("Added skills directory", path=str(path))

get_skills_provider

get_skills_provider() -> SkillsResourceProvider

Get the skills resource provider for agents.

Source code in src/llmling_agent/skills/manager.py

def get_skills_provider(self) -> SkillsResourceProvider:
    """Get the skills resource provider for agents."""
    return self.provider

refresh_skills async

refresh_skills() -> None

Refresh skills discovery.

Source code in src/llmling_agent/skills/manager.py

async def refresh_skills(self) -> None:
    """Refresh skills discovery."""
    await self.provider.refresh()
    skill_count = len(self.registry.list_items())
    logger.info("Skills refreshed", name=self.name, skill_count=skill_count)