Skip to content

skill_tools

Runtime tools for manifest-based skills.

build_load_skill_tool(skill_runtime)

Build a runtime tool that loads full SKILL.md content by skill name.

Parameters:

Name Type Description Default
skill_runtime SkillRuntime

Runtime access layer for manifest-based skills.

 required

Returns:

Type Description
Callable[[str], str]

Callable tool that returns the full content for a named skill.
Source code in src/mada/core/skills/skill_tools.py 
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
def build_load_skill_tool(skill_runtime: SkillRuntime) -> Callable[[str], str]:
    """
    Build a runtime tool that loads full SKILL.md content by skill name.

    Args:
        skill_runtime: Runtime access layer for manifest-based skills.

    Returns:
        Callable tool that returns the full content for a named skill.
    """

    def load_skill(skill_name: str) -> str:
        """
        Load the full SKILL.md body for a manifest-discovered skill.

        Args:
            skill_name: Unique manifest skill name to load.

        Returns:
            Full markdown content of the requested skill.
        """
        LOG.debug(f"Tool 'load_skill' invoked for skill '{skill_name}'")
        return skill_runtime.load_skill(skill_name)

    # Keep the callable self-describing for the runtime/tooling layers.
    load_skill.__name__ = "load_skill"
    load_skill.name = "load_skill"
    load_skill.description = (
        "Load the full SKILL.md instructions for a manifest-based skill by name."
    )
    LOG.debug("Built runtime tool 'load_skill'")
    return load_skill

build_read_skill_resource_tool(skill_runtime)

Build a runtime tool that loads one discovered skill resource on demand.

Parameters:

Name Type Description Default
skill_runtime SkillRuntime

Runtime access layer for manifest-based skills.

 required

Returns:

Type Description
Callable[[str, str], str]

Callable tool that returns validated text resource content.
Source code in src/mada/core/skills/skill_tools.py 
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
def build_read_skill_resource_tool(
    skill_runtime: SkillRuntime,
) -> Callable[[str, str], str]:
    """
    Build a runtime tool that loads one discovered skill resource on demand.

    Args:
        skill_runtime: Runtime access layer for manifest-based skills.

    Returns:
        Callable tool that returns validated text resource content.
    """

    def read_skill_resource(skill_name: str, resource_path: str) -> str:
        """
        Load one discovered resource file for a manifest-based skill.

        Args:
            skill_name: Unique manifest skill name.
            resource_path: Relative resource path such as 'references/guide.md'.

        Returns:
            Full text content of the requested resource.
        """
        LOG.debug(
            f"Tool 'read_skill_resource' invoked for skill '{skill_name}' "
            f"and resource '{resource_path}'"
        )
        return skill_runtime.read_skill_resource(skill_name, resource_path)

    read_skill_resource.__name__ = "read_skill_resource"
    read_skill_resource.name = "read_skill_resource"
    read_skill_resource.description = (
        "Read a discovered text resource for a manifest-based skill by skill name "
        "and relative resource path."
    )
    LOG.debug("Built runtime tool 'read_skill_resource'")
    return read_skill_resource

build_run_skill_script_tool(skill_runtime)

Build a runtime tool that validates, approves, and executes one skill script.

Parameters:

Name Type Description Default
skill_runtime SkillRuntime

Runtime access layer for manifest-based skills.

 required

Returns:

Type Description
Callable[[str, str, list[str] | None], dict[str, Any]]

Callable tool that returns a structured execution result.
Source code in src/mada/core/skills/skill_tools.py 
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
def build_run_skill_script_tool(
    skill_runtime: SkillRuntime,
) -> Callable[[str, str, list[str] | None], dict[str, Any]]:
    """
    Build a runtime tool that validates, approves, and executes one skill script.

    Args:
        skill_runtime: Runtime access layer for manifest-based skills.

    Returns:
        Callable tool that returns a structured execution result.
    """

    def run_skill_script(
        skill_name: str,
        script_name: str,
        args: list[str] | None = None,
    ) -> dict[str, Any]:
        """
        Validate, approve, and execute one discovered skill script.

        Args:
            skill_name: Unique manifest skill name.
            script_name: Relative script path such as 'scripts/report.py'.
            args: Optional argument list for the script process.

        Returns:
            Structured approval and execution result for the script.
        """
        LOG.info(
            f"Tool 'run_skill_script' invoked for skill '{skill_name}' "
            f"and script '{script_name}'"
        )
        return skill_runtime.run_skill_script(skill_name, script_name, args=args)

    run_skill_script.__name__ = "run_skill_script"
    run_skill_script.name = "run_skill_script"
    run_skill_script.description = (
        "Validate, request approval for, and execute a discovered manifest-based "
        "skill script by skill name and relative script path."
    )
    LOG.debug("Built runtime tool 'run_skill_script'")
    return run_skill_script