Skip to content

skill_setup

Shared setup for manifest-based skills.

Builds the skill registry, runtime, and runtime tools from an application configuration so every interface initializes skills the same way.

initialize_skill_state(config)

Discover manifest-based skills and build their runtime tools.

Parameters:

Name Type Description Default
config AppConfig

Application configuration containing the resolved skills

 required

Returns:

Type Description
SkillRegistry

Tuple containing the populated skill registry and the list of runtime
List[Any]

tools to expose to the planner.
Source code in src/mada/core/skills/skill_setup.py 
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
def initialize_skill_state(config: AppConfig) -> Tuple[SkillRegistry, List[Any]]:
    """
    Discover manifest-based skills and build their runtime tools.

    Args:
        config: Application configuration containing the resolved skills

    Returns:
        Tuple containing the populated skill registry and the list of runtime
        tools to expose to the planner.
    """
    skills_config = config.skills
    LOG.debug(
        f"Initializing skills from {len(skills_config.skill_paths)} configured path(s)"
    )
    skill_registry = SkillRegistry.discover(skills_config.skill_paths)
    skill_runtime = SkillRuntime(
        skill_registry,
        config=skills_config.skill_runtime,
        script_approver=build_skill_script_approver(skills_config.skill_runtime),
    )

    skill_tools = []
    if skill_registry.has_skills_for_tool("load_skill"):
        skill_tools.append(build_load_skill_tool(skill_runtime))
    if skill_registry.has_resources_for_tool("read_skill_resource"):
        skill_tools.append(build_read_skill_resource_tool(skill_runtime))
    if skill_registry.has_scripts_for_tool("run_skill_script"):
        skill_tools.append(build_run_skill_script_tool(skill_runtime))

    LOG.info(f"Skill setup complete with {len(skill_tools)} runtime tool(s) available")
    return skill_registry, skill_tools