Skip to content
kazma.
ع Star 6 Get Started

Creating Skills

Creating Skills

Section titled “Creating Skills”

Skills extend Kazma with tools and workflows. Prefer the native tools shape used by built-in skills under kazma-skills/kazma_skills/native/.

Section titled “Recommended: native tools skill”

Layout

Section titled “Layout”
my_skill/
  skill_manifest.yaml   # name, tools: map
  tools.py              # async callables named like the tools map keys

Manifest (tools: map)

Section titled “Manifest (tools: map)”
name: my-example-skill
version: 0.1.0
description: Example native skill
author: your-name
license: MIT


tools:
  example_echo:
    description: Echo a message back for testing.
    category: utility
    arabic_name: "مثال"
    prompt_chain:
      - "Echo the user's message"

Implementation (tools.py)

Section titled “Implementation (tools.py)”
from __future__ import annotations


async def example_echo(message: str = "") -> str:
    """Must match the tool name key in the manifest."""
    return f"echo: {message}"

Load path

Section titled “Load path”

NativeSkillLoader (kazma_skills/native_loader.py) discovers each native folder, reads tools:, imports tools.py, and register_functions each tool into LocalToolRegistry. Danger tools still hit HITL on execute.

Ship it

Section titled “Ship it”
Terminal window
# For a path skill package:
kazma hub validate ./my_skill
kazma hub sign ./my_skill
kazma hub register ./my_skill


# Built-in natives under kazma-skills are auto-discovered at app start.

See real examples: secret_vault, git_github_manager, task_scheduler_cron under kazma-skills/kazma_skills/native/.

Alternate: class entry-point skill

Section titled “Alternate: class entry-point skill”

Some hub packages use entry_point: main:MySkill. That shape is supported by validation/cert checks, but native tools are the pattern used by production built-ins. If you use a class, implement a clear contract and document it — do not assume a single global execute(context) framework API beyond what your loader expects.

Testing

Section titled “Testing”
Terminal window
kazma hub validate ./my_skill
pytest path/to/tests -v

Next steps

Section titled “Next steps”