multi-script v1.0.0A

Immutable. This exact content is served forever at /api/v1/blob/098586d8bb5295c1.

---
name: multi-script
description: "Demonstrates a skill with multiple script types — Python, Shell, and Batch. Use as a reference when writing cross-platform skills that run different script languages."
license: MIT
compatibility: Python 3.7+; bash required on Linux/macOS; cmd on Windows
allowed-tools: Bash Read
metadata:
  category: example
  author: dcc-mcp-core
tags: [example, multi-language, cross-platform]
dcc: python
version: "1.0.0"
search-hint: "multi-script, cross-platform, python, shell, batch, script types, example"
tools:
  - name: action_python
    description: Runs the Python implementation of the action
    input_schema:
      type: object
      properties:
        message:
          type: string
          description: Message to process
          default: hello
    read_only: true
    idempotent: true
    source_file: scripts/action_python.py

  - name: action_shell
    description: Runs the Shell (bash) implementation of the action (Linux/macOS)
    input_schema:
      type: object
      properties:
        message:
          type: string
          description: Message to process
          default: hello
    read_only: true
    idempotent: true
    source_file: scripts/action_shell.sh

  - name: action_batch
    description: Runs the Batch (cmd) implementation of the action (Windows)
    input_schema:
      type: object
      properties:
        message:
          type: string
          description: Message to process
          default: hello
    read_only: true
    idempotent: true
    source_file: scripts/action_batch.bat
---

# Multi-Script Skill

A reference skill demonstrating **cross-platform, multi-language script support**
in `dcc-mcp-core`.

## Supported Script Extensions

| Extension | Language | Platform |
|-----------|----------|----------|
| `.py` | Python | All |
| `.sh` | Shell/Bash | Linux, macOS |
| `.bat` | Batch/CMD | Windows |
| `.ps1` | PowerShell | Windows |
| `.mel` | MEL | Maya |
| `.ms` / `.mcr` | MaxScript | 3ds Max |
| `.js` | JavaScript | Node.js |

## Tools

### `multi_script__action_python`
Cross-platform Python implementation — works on all operating systems.

### `multi_script__action_shell`
Bash shell implementation for Linux and macOS.

### `multi_script__action_batch`
Windows Batch (CMD) implementation for Windows environments.

## How the dispatcher chooses a script

When a tool is called via `tools/call`, the `SkillCatalog` uses the
`source_file` field in each `ToolDeclaration` to dispatch to the correct
script. If `source_file` is empty, it matches scripts by name stem.

## Script convention

All scripts in this skill read JSON parameters from **stdin** and write
a JSON result to **stdout**:

```python
# action_python.py
import json, sys
params = json.load(sys.stdin)
msg = params.get("message", "hello")
print(json.dumps({"success": True, "message": f"Python says: {msg}"}))
```