codeact

Generate and execute code for acting with Python tools. Activate when user explicitly requests to "use the codeact skill" or similar phrases.

⭐55stars🔀14forks📁View on GitHub🕐Updated Dec 25, 2025⬇️1downloads

When & Why to Use This Skill

The CodeAct skill empowers Claude to dynamically generate and execute Python code to interact with a wide array of tools. By leveraging the ipybox MCP server and a sophisticated workflow for tool selection and chaining, it transforms Claude into an active agent capable of performing complex, multi-step technical tasks and creating reusable automation scripts.

Use Cases

  • Complex Tool Chaining: Automatically orchestrating workflows where the output of one Python tool serves as the direct input for another to complete intricate tasks.
  • Dynamic Custom Automation: Generating and running bespoke Python scripts on the fly to solve specific problems that pre-defined tools cannot handle.
  • Advanced Data Processing: Utilizing Python's computational power to filter, transform, and analyze data retrieved from various filesystem and MCP tools before delivering results.
  • Extensible Skill Development: Saving successful code execution sequences as new, reusable 'gentools' to permanently expand the agent's functional capabilities.
namecodeact
descriptionGenerate and execute code for acting with Python tools. Activate when user explicitly requests to "use the codeact skill" or similar phrases.

Use Python tools to perform tasks.

You must use the execute_ipython_cell tool of the ipybox MCP server for executing Python code.

All operations must follow the tool usage restrictions and workflows defined below.

Tool Directories

The gentools/ and mcptools/ directories are in the working directory shown in your <env> block. All paths are relative to the working directory, NOT to this skill's base directory.

Tool Usage Restrictions

You are restricted to these tools only:

Python Tools

  • Functions in mcptools/<category>/<tool>.py (use run_parsed if defined, otherwise run)
  • Functions in gentools/<category>/<tool>/api.py

ipybox MCP Server Tools

  • execute_ipython_cell - Execute Python code
  • reset - Reset the IPython kernel

Claude Code Filesystem Tools

  • All filesystem tools for reading, writing files, and listing directories.

Workflow

1. Python Tool Selection

  1. List available categories in gentools/ and mcptools/
  2. List available tools in relevant categories
  3. Read tool files to understand interfaces and parameters.

2. Python Tool Priority

  1. Search gentools package first
  2. If not found, search mcptools package
  3. If no appropriate tool exists, generate custom code

3. Code Generation and Python Tool Chaining

  • Generate code that uses selected Python tools as argument for execute_ipython_cell.
  • Chain Python tools in the generated code if the structured output of one tool can be used as input for another tool.

4. Code Execution

  • Use the execute_ipython_cell for Python code execution
  • Print only required information, not intermediate results
  • Store intermediate results in variables

Output Parsers

When generating output parsers for Python tools in the mcptools package, see references/output-parsers.md.

Saving Code Actions

To save executed code as a reusable gentools tool, see references/saving-codeacts.md.