Agent Folder Skill

Agent Folder is an agent skill for Codex and other AI coding assistants. It establishes a repository-local .agent/ workspace for agent-owned notes, research, handovers, helper scripts, reports, and other operational material.

It keeps this working context separate from application source and human-facing project documentation, while letting every repository choose the structure that fits its work.

Why This Matters

AI-assisted work often creates useful context that does not belong in the source tree: an investigation worth preserving, a handover for the next session, a small repeatable script, or a report that explains a result.

A clear .agent/ folder gives that material a predictable home. It makes work easier to resume, keeps project files focused, and avoids scattering agent notes and operational artifacts across unrelated directories.

Installing Agent Folder

Install the skill with npx:

npx skills add https://github.com/Gucky/AgentFolder --skill agent-folder

To install it globally for Codex:

npx skills add https://github.com/Gucky/AgentFolder --skill agent-folder --agent codex --global

For a specific agent:

npx skills add https://github.com/Gucky/AgentFolder --skill agent-folder --agent claude-code

For all supported agents:

npx skills add https://github.com/Gucky/AgentFolder --skill agent-folder --agent '*'

Using Agent Folder

In Codex, trigger the skill directly:

$agent-folder

Or ask naturally:

Use Agent Folder to organize the research notes, handover, and helper scripts for this project.

The skill helps agents to:

• organize agent-owned notes, research, handovers, scripts, reports, and caches under .agent/;
• preserve project conventions instead of imposing a rigid folder structure;
• keep operational material separate from application source and human-facing documentation;
• retain useful context for later people and agents; and
• ask before adding new generated caches or interpreter artifacts to .gitignore.

Scope and Safety

Agent Folder is a flexible workspace convention, not a prescribed project structure. Existing project rules decide the exact layout and what belongs in version control.

The skill does not store credentials, personal data, or unnecessary large artifacts. When a build, download, script, or interpreter creates a new cache that is not already covered by repository rules, it asks whether that cache should be added to .gitignore rather than changing ignore rules automatically.

Requirements

• Node.js for npx installation
• An AI coding assistant that supports agent skills

License

Agent Folder was created by Wolfgang Muhsal. It is available under the MIT License.