Custom Skills

1
def setup(self) -> bool:
2
    if not self.validate_packages():
3
        return False
4
    if not self.validate_env_vars():
5
        return False
6
    self.api_url = self.params.get("api_url", "https://api.example.com")
7
    self.timeout = self.params.get("timeout", 30)
8
    return True

1
def register_tools(self) -> None:
2
    self.define_tool(
3
        name="my_function",
4
        description="Does something useful",
5
        parameters={
6
            "param1": {"type": "string", "description": "First parameter"},
7
            "param2": {"type": "integer", "description": "Second parameter"}
8
        },
9
        handler=self.my_handler
10
    )

1
def get_hints(self) -> List[str]:
2
    return ["greeting", "hello", "hi", "welcome"]

1
def get_prompt_sections(self) -> List[Dict[str, Any]]:
2
    return [{
3
        "title": "Greeting Capability",
4
        "body": "You can greet users by name.",
5
        "bullets": ["Use greet_user when someone introduces themselves",
6
                    "Match the greeting style to the conversation tone"]
7
    }]

1
def get_global_data(self) -> Dict[str, Any]:
2
    return {"greeting_skill_enabled": True, "greeting_style": self.greeting_style}

1
def cleanup(self) -> None:
2
    if hasattr(self, "connection"):
3
        self.connection.close()

1
agent.add_skill("my_skill", {"skip_prompt": True, "api_key": "..."})

1
class MySkill(SkillBase):
2
    def _get_prompt_sections(self) -> List[Dict[str, Any]]:
3
        return [{"title": "My Skill", "body": "Usage instructions..."}]

1
class StatefulSkill(SkillBase):
2
    SKILL_NAME = "stateful_skill"
3
    SUPPORTS_MULTIPLE_INSTANCES = True
4
5
    def my_handler(self, args, raw_data):
6
        state = self.get_skill_data(raw_data)
7
        count = state.get("call_count", 0)
8
        result = FunctionResult(f"Call #{count + 1}")
9
        self.update_skill_data(result, {"call_count": count + 1})
10
        return result

1
@classmethod
2
def get_parameter_schema(cls) -> Dict[str, Dict[str, Any]]:
3
    schema = super().get_parameter_schema()
4
    schema.update({
5
        "style": {"type": "string", "description": "Greeting style", "default": "friendly",
6
                  "enum": ["friendly", "formal", "casual"], "required": False},
7
        "api_key": {"type": "string", "description": "API key for external service",
8
                   "required": True, "hidden": True, "env_var": "MY_SKILL_API_KEY"}
9
    })
10
    return schema

1
class MultiInstanceSkill(SkillBase):
2
    SKILL_NAME = "multi_search"
3
    SUPPORTS_MULTIPLE_INSTANCES = True
4
5
    def get_instance_key(self) -> str:
6
        tool_name = self.params.get("tool_name", self.SKILL_NAME)
7
        return f"{self.SKILL_NAME}_{tool_name}"
8
9
    def setup(self) -> bool:
10
        self.tool_name = self.params.get("tool_name", "search")
11
        return True
12
13
    def register_tools(self) -> None:
14
        self.define_tool(
15
            name=self.tool_name,
16
            description="Search function",
17
            parameters={"query": {"type": "string", "description": "Search query"}},
18
            handler=self.search_handler
19
        )

1
from signalwire.skills.registry import skill_registry
2
3
## Add your skills directory
4
skill_registry.add_skill_directory("/path/to/my_skills")
5
6
## Now use in agent
7
class MyAgent(AgentBase):
8
    def __init__(self):
9
        super().__init__(name="my-agent")
10
        self.add_language("English", "en-US", "rime.spore")
11
        self.add_skill("product_search", {
12
            "api_url": "https://api.mystore.com",
13
            "api_key": "secret"
14
        })

1
from my_skills.product_search.skill import ProductSearchSkill
2
3
class MockAgent:
4
    def define_tool(self, **kwargs):
5
        print(f"Registered tool: {kwargs['name']}")
6
7
skill = ProductSearchSkill(MockAgent())
8
skill.params = {"api_url": "http://test", "api_key": "test"}
9
assert skill.setup() == True
10
skill.register_tools()

1
from signalwire.skills.registry import skill_registry
2
skill_registry.add_skill_directory("/path/to/my_skills")
3
available = skill_registry.list_available_skills()
4
print(f"Available skills: {available}")

1
skill_registry.add_skill_directory("/path/to/my_company_skills")

1
setup(
2
    name="my_company_skills",
3
    entry_points={
4
        "signalwire.skills": [
5
            "product_search = my_company_skills.product_search.skill:ProductSearchSkill",
6
            "crm_integration = my_company_skills.crm_integration.skill:CRMSkill",
7
        ]
8
    }
9
)