Agent skill

codeact

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

Stars 74
Forks 18

Install this agent skill to your Project

npx add-skill https://github.com/gradion-ai/ipybox/tree/main/plugin/skills/codeact

SKILL.md

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.

Expand your agent's capabilities with these related and highly-rated skills.

gradion-ai/freeact

freeact-interaction

Interact with freeact agent via tmux for testing

129 9
Explore
gradion-ai/freeact

output-parsers

Generate output parsers for mcptools with unstructured return types. Use when a tool returns raw strings or Result models with single str fields and needs structured ParseResult output. Covers testing tools, identifying parseable structures, extending modules with ParseResult models, and creating parser implementations.

129 9
Explore
gradion-ai/freeact

saving-codeacts

Save executed Python code as reusable tools in the gentools package. Use when preserving successful code executions for later reuse. Covers creating package structure (api.py, impl.py), defining Pydantic output models, and implementing the run() interface.

129 9
Explore
gradion-ai/freeact

task-planning

Structured task planning workflow with user feedback loops. Use when the user explicitly requests planning (e.g., "make a plan", "plan first", "create a plan"). Covers creating plans with actionable steps, iterating based on feedback, saving confirmed plans, and executing step-by-step with progress tracking.

129 9
Explore
sickn33/antigravity-awesome-skills

obsidian-clipper-template-creator

Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.

28,421 4,766
Explore
sickn33/antigravity-awesome-skills

claude-code-expert

Especialista profundo em Claude Code - CLI da Anthropic. Maximiza produtividade com atalhos, hooks, MCPs, configuracoes avancadas, workflows, CLAUDE.md, memoria, sub-agentes, permissoes e integracao com ecossistemas.

28,421 4,766
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results