Agent Task Workspace Skill

Agent Task Workspace is an agent skill for Codex and other AI coding assistants. It creates and maintains durable, task-local records for tickets and other documented work: purpose, rationale, investigation findings, decisions, changes, outcomes, scripts, reports, and reproducible evidence.

It is useful for individual tickets completed in one session as well as for long-running tickets, audits, migrations, and recurring analyses. A future agent can connect a ticket number or Git commit to the context behind a change instead of inferring everything from commit messages alone.

Installing Agent Task Workspace

Install the skill with npx:

npx skills add https://github.com/Gucky/AgentTaskWorkspace --skill agent-task-workspace

To install it globally for Codex:

npx skills add https://github.com/Gucky/AgentTaskWorkspace --skill agent-task-workspace --agent codex --global

For a specific agent:

npx skills add https://github.com/Gucky/AgentTaskWorkspace --skill agent-task-workspace --agent claude-code

For all supported agents:

npx skills add https://github.com/Gucky/AgentTaskWorkspace --skill agent-task-workspace --agent '*'

Using Agent Task Workspace

In Codex, trigger the skill directly:

$agent-task-workspace

Or ask naturally:

Use Agent Task Workspace to document this ticket, including its rationale, investigated alternatives, final change, verification, and related commit IDs.

The skill helps agents to:

• document the purpose, rationale, decisions, changes, and outcome of short or long-running tasks;
• connect ticket IDs and Git commits to their underlying investigation and implementation context;
• keep scripts, reports, caches, and run records with the task they support;
• ask whether generated task artifacts should be tracked, excluded, or kept temporary; and
• retain enough provenance for future agents to refresh evidence safely.

Scope and Safety

The skill keeps task artifacts outside the source tree and adapts to existing repository rules. A project may choose to document every AI-assisted ticket, including small ones. Before creating or retaining caches, run output, downloaded inputs, build products, or other generated artifacts as repository content, the skill checks the project's ignore rules and asks whether they should be tracked, excluded, or kept temporary. It does not store secrets or oversized captures, and does not replace project documentation with operational notes.

Requirements

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

License

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