# Code

> Codebase reading and white-box debugging capabilities.

- Skill: `camel-ai/code` (Agent Skill)
- Install (CLI): `npx skillmds@latest add camel-ai/code`
- Raw SKILL.md: https://api.skillmd.com/api/skills/camel-ai/code/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: camel-ai (https://skillmd.com/u/camel-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/camel-ai/code

---


# Codebase Debugging Skill

This skill grants the agent the ability to inspect the target software's source code and perform white-box debugging via temporary code injection.

## 🛠 Tools
- `code_list_files`: Discover the structure of the environment codebase.
- `code_read_file`: Read source code to understand logic or identify bugs.
- `code_search`: Search for keywords or patterns across the entire codebase.
- `code_write_file`: Inject `print()` statements or temporary fixes to diagnose complex issues.
- `code_restore_file`: Revert any modifications made during debugging.

## 📖 Best Practices
1. **Prefer read-only actions first**: Start with `code_list_files`, `code_read_file`, or `code_search` to find relevant handlers before modifying files.
2. **Safe Debugging**: Before using `code_write_file`, ensure you have a plan to use `code_restore_file`.
3. **White-box Inspection**: When an environment error is ambiguous, search for the error message in the codebase to find where it's raised.
4. **Injection**: Use `print()` to trace variable states in the sandbox. Logs can be read via `log_analyze`.

## ⚠️ Safety
- Never modify files permanently. Always restore files before concluding the session.
- Only use these tools within the `/sandbox/software` directory (handled automatically).