# Python Example

> Example Python skill demonstrating the SDK decorator pattern

- **Type:** Skill
- **Install:** `agentstack add skill-kubiyabot-skill-python-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kubiyabot](https://agentstack.voostack.com/s/kubiyabot)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [kubiyabot](https://github.com/kubiyabot)
- **Source:** https://github.com/kubiyabot/skill/tree/main/examples/wasm-skills/python-skill

## Install

```sh
agentstack add skill-kubiyabot-skill-python-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Python Example Skill

A comprehensive example demonstrating Python SDK features including decorators, configuration, multiple tools, and proper error handling.

## When to Use

- Learning how to build skills with the Python SDK
- Testing the skill-engine runtime with Python-based skills
- As a template for creating new Python skills

## Tools Provided

### greet

Greet someone with a personalized message. Supports formal and informal greeting styles.

**Usage**:
```bash
skill run python-example:greet --name "Alice"
skill run python-example:greet --name "Alice" --formal true
```

**Parameters**:
- `name` (optional): The name of the person to greet (default: "World")
- `formal` (optional): Use formal greeting style (default: false)

**Example**:
```bash
$ skill run python-example:greet --name "Developer"
Hello, Developer!

$ skill run python-example:greet --name "CEO" --formal true
Good day, CEO. How may I assist you?
```

### echo

Echo back a message with optional transformations like uppercase or reverse.

**Usage**:
```bash
skill run python-example:echo --message "Hello World"
skill run python-example:echo --message "hello" --uppercase true
skill run python-example:echo --message "stressed" --reverse true
```

**Parameters**:
- `message` (required): The message to echo
- `uppercase` (optional): Convert message to uppercase (default: false)
- `reverse` (optional): Reverse the message (default: false)

**Example**:
```bash
$ skill run python-example:echo --message "stressed" --reverse true
desserts
```

### calculate

Perform basic arithmetic operations on two numbers.

**Usage**:
```bash
skill run python-example:calculate --a 10 --b 5 --operation add
skill run python-example:calculate --a 100 --b 7 --operation divide
```

**Parameters**:
- `a` (required): First number
- `b` (required): Second number
- `operation` (optional): Operation to perform - add, subtract, multiply, divide (default: "add")

**Example**:
```bash
$ skill run python-example:calculate --a 15 --b 3 --operation multiply
15 multiply 3 = 45
```

### process_list

Process a JSON array of numbers and return statistics including count, sum, min, max, and average.

**Usage**:
```bash
skill run python-example:process_list --items '[1, 2, 3, 4, 5]'
```

**Parameters**:
- `items` (required): JSON array of numbers to process

**Example**:
```bash
$ skill run python-example:process_list --items '[10, 20, 30, 40, 50]'
Processed 5 items
{
  "count": 5,
  "sum": 150,
  "min": 10,
  "max": 50,
  "average": 30.0
}
```

### status

Get current skill configuration and status including available tools.

**Usage**:
```bash
skill run python-example:status
```

**Example**:
```bash
$ skill run python-example:status
{
  "skill_name": "python-example",
  "version": "1.0.0",
  "config": {
    "greeting_prefix": "Hello",
    "max_items": 100
  },
  "tools_available": ["greet", "echo", "calculate", "process_list", "status"]
}
```

## Configuration

This skill supports the following configuration options:

```bash
# Set greeting prefix
skill config python-example --set greeting_prefix="Hi there"

# Set maximum items for list processing
skill config python-example --set max_items=50
```

## Building from Source

```bash
cd examples/python-skill

# Install dependencies
pip install -e ../../sdk/python[build]

# Build to WASM component
skill-sdk build

# Install in skill-engine
skill install ./python-example.wasm
```

## Development

```bash
# Run tests
skill-sdk test

# Validate project structure
skill-sdk validate

# Show skill info
skill-sdk info
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kubiyabot](https://github.com/kubiyabot)
- **Source:** [kubiyabot/skill](https://github.com/kubiyabot/skill)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kubiyabot-skill-python-skill
- Seller: https://agentstack.voostack.com/s/kubiyabot
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.