Skip to content
Development
Skill

/codeact

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

From plugin
ipybox
761 skill

Claude Code

$ npx -y skills add gradion-ai/ipybox --skill codeact --agent claude-code

SKILL.md

codeact.SKILL.md
name: codeact
description: Generate 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](references/output-parsers.md).

Saving Code Actions

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

Read more
Stats
76
Stars
18
Forks
Maintained
Maintenance
Python
Language
Apache-2.0
License
Last commit
Created

Repo: gradion-ai/ipybox

@gradion-ai
Ships withipybox

mcp-name: io.github.gradion-ai/ipybox ipybox is a unified execution environment for Python code, shell commands, and programmatic MCP tool calls.

Stars on GitHub

Momentum

stars in total
76
Star history of gradion-ai/ipybox on GitHub, a chart by star-history.com

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about codeact.

Which coding agents can use codeact?
codeact installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.