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.
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(userun_parsedif defined, otherwiserun) - Functions in
gentools/<category>/<tool>/api.py
ipybox MCP Server Tools
execute_ipython_cell- Execute Python codereset- Reset the IPython kernel
Claude Code Filesystem Tools
- All filesystem tools for reading, writing files, and listing directories.
Workflow
1. Python Tool Selection
- List available categories in
gentools/andmcptools/ - List available tools in relevant categories
- Read tool files to understand interfaces and parameters.
2. Python Tool Priority
- Search
gentoolspackage first - If not found, search
mcptoolspackage - 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_cellfor 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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
freeact-interaction
Interact with freeact agent via tmux for testing
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.
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.
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.
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.
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.
Didn't find tool you were looking for?