name: code-runner description: Run code snippets in 30+ programming languages including JavaScript, Python, TypeScript, Java, C, C++, Go, Rust, Ruby, PHP, and more. Use when the user wants to execute code, test algorithms, verify output, run scripts, or check code behavior. Supports both interpreted and compiled languages.

Code Runner Skill

This skill enables you to run code snippets in multiple programming languages directly from the command line.

When to Use This Skill

Use this skill when: - The user wants to run or execute a code snippet - Testing algorithm implementations or logic - Verifying expected output of code - Running quick scripts or one-liners - Checking syntax or runtime behavior - Demonstrating code functionality

Supported Languages

The following languages are supported (requires the interpreter/compiler to be installed):

See references/LANGUAGES.md for detailed language configuration.

How to Run Code

Step 1: Identify the Language

Determine the programming language from: - User's explicit request (e.g., "run this Python code") - File extension if provided - Code syntax patterns

Step 2: Execute Using the Runner Script

⚠️ Important for AI Agents: Use stdin to avoid escaping issues with quotes, backslashes, and special characters.

Recommended Method (stdin):

echo "<code>" | node scripts/run-code.cjs <languageId>

Alternative Method (CLI argument - for simple code only):

node scripts/run-code.cjs <languageId> "<code>"

Example - JavaScript:

echo "console.log('Hello, World!')" | node scripts/run-code.cjs javascript

Example - Python:

echo "print('Hello, World!')" | node scripts/run-code.cjs python

Example - Java (multi-line):

echo "public class Test {
    public static void main(String[] args) {
        System.out.println(\"Hello from Java!\");
    }
}" | node scripts/run-code.cjs java

Example - Multi-line code from variable:

# In bash
CODE='import math
print("Pi:", math.pi)
print("Result:", math.factorial(5))'
echo "$CODE" | node scripts/run-code.cjs python

# In PowerShell (inline here-string)
@"
import math
print("Pi:", math.pi)
print("Result:", math.factorial(5))
"@ | node scripts/run-code.cjs python

Step 3: Return Results

• Show the output (stdout) to the user
• If there are errors (stderr), explain what went wrong
• Suggest fixes for common errors

Platform Notes

Windows

• Use cmd /c for batch scripts
• PowerShell scripts require pwsh or powershell
• Path separators use backslash \

macOS / Linux

• Bash scripts work natively
• Swift available on macOS
• Use #!/usr/bin/env shebang for portable scripts

Error Handling

Common issues and solutions:

1. Command not found: The language interpreter is not installed or not in PATH
2. Suggest installing the required runtime

3. Provide installation instructions

4. Syntax errors: Code has syntax issues

5. Show the error message

6. Point to the line number if available

7. Runtime errors: Code runs but fails during execution

8. Display the stack trace

9. Explain the error type

10. Timeout: Code takes too long (default: 30 seconds)

11. Warn about infinite loops
12. Suggest optimizations

Security Considerations

⚠️ Important: Running arbitrary code can be dangerous. Always:

1. Review the code before execution
2. Be cautious with code that:
3. Accesses the file system
4. Makes network requests
5. Executes system commands
6. Modifies environment variables
7. Consider running in a sandboxed environment for untrusted code

Examples

Example 1: Run a JavaScript calculation

echo "console.log(Array.from({length: 10}, (_, i) => i * i))" | node scripts/run-code.cjs javascript

Output: [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]

Example 2: Run Python with imports

echo "import math; print(math.factorial(10))" | node scripts/run-code.cjs python

Output: 3628800

Example 3: Test a Go function

echo 'package main; import "fmt"; func main() { fmt.Println("Hello from Go!") }' | node scripts/run-code.cjs go

Output: Hello from Go!

这个 Skill 质量不错，能运行30多种编程语言的代码，适合需要快速验证代码效果的场景。文档写得清楚详细，支持通过标准输入传递代码不容易出错，还有超时保护防止代码卡死。唯一的小遗憾是某些小众语言的支持细节文档和实际工具有细微不一致，极端情况下临时文件可能清理不完全，整体瑕不掩瑜。