Code Agent

What it does

Example prompts

• “/code-agent”

Requirements

• Python 3
• Node.js
• A Bash shell

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Every response MUST include tool calls. A response with only text is a failure. If you have something to say, say it AND call tools in the…
2. 2NEVER say "I'll do X now" without doing X. No planning text. No "Let me patch that." JUST DO IT — call the tools.
3. 3NEVER ask for confirmation. Do not ask "Should I proceed?" or "Would you like me to...?" — just act.
4. 4NEVER output code in markdown blocks. You have file tools. Use them.
5. 5Complete the ENTIRE request in ONE turn. Scaffold + write all files + run — all in a single response.
6. 6ONE project per app. NEVER create multiple projects for a single application. Full-stack apps use ONE project where the backend serves the…
7. 7NEVER scaffold over existing code. If a project already exists in the workspace — whether you created it or the user placed it there — use…

What it can do on your machine

Read from SKILL.md and the folder at commit 3c608d8. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 5 files in scripts/ (Shell), which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Code Agent loads about 2.5k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 922 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~25

When it runs · the whole SKILL.md, loaded when a task matches

~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:58

  3. **NEVER ask for confirmation.** Do not ask "Should I proceed?" or "Would you like me to...?" — just act.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from initializ/forge at commit 3c608d8, republished under its Apache-2.0 licence (© initializ). 922 words, ~2,472 tokens.

name

code-agent

description

General-purpose coding agent that reads, writes, and edits code, and searches codebases.

icon

💻

category

developer

tags

coding, development, debugging, refactoring

1. code_agent_scaffold  → create skeleton
2. code_agent_write     → write ALL source files (call multiple times)
3. code_agent_run       → install deps + start server + open browser
4. Brief summary + URL

1. directory_tree       → discover project structure
2. code_agent_read      → read key files to understand the codebase
3. code_agent_edit      → apply changes (or code_agent_write for new files)
4. code_agent_run       → start the server if not already running
5. Brief summary of changes

1. code_agent_read      → read file(s) to change
2. code_agent_edit      → apply targeted changes (or code_agent_write for rewrites)
3. Brief summary of changes

{
  "status": "created",
  "project_name": "my-app",
  "framework": "react",
  "project_dir": "/path/to/workspace/my-app",
  "files": ["package.json", "vite.config.js", "index.html", "src/main.jsx", "src/App.jsx", ".gitignore"]
}

{"path": "src/App.jsx", "action": "created", "size": 312}

{"path": "src/App.jsx", "content": "...", "size": 245, "modified": "2025-01-15T10:30:00Z"}

{"path": ".", "type": "directory", "files": ["package.json", "src/App.jsx"]}

{"path": "src/App.jsx", "action": "edited", "size": 320, "diff": "..."}

{"status": "running", "url": "http://localhost:3000", "pid": 12345, "project_dir": "/path/to/my-app", "install": "installed", "type": "node", "command": "npm run dev"}

© initializ, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts) in skills/code-agent of initializ/forge.

• SKILL.md
• scripts/code-agent-edit.sh
• scripts/code-agent-read.sh
• scripts/code-agent-run.sh
• scripts/code-agent-scaffold.sh
• scripts/code-agent-write.sh

Open the folder on GitHubat commit 3c608d8