workspace

Read and set active_skill_workspace in skill-config.json to resolve the engagement root.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/agilebydesign/agilebydesign-skills --skill workspace-agilebydesign
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace
Source: https://github.com/agilebydesign/agilebydesign-skills/tree/main/skills/workspace_skill
Command: npx skills add https://github.com/agilebydesign/agilebydesign-skills --skill workspace-agilebydesign

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manage and locate the agent engagement workspace by reading and setting workspace.active_skill_workspace in skill-config.json, consolidating paths for all engagement artifacts.

Core Features & Use Cases

  • Get and set the active workspace with Python scripts to resolve the engagement root.
  • Ensure engagement plans, outputs, and corpus data live under the active workspace rather than inside the agent package.
  • Simplify scripting and cross-project work by providing a consistent workspace resolution mechanism.

Quick Start

From the agent root, run the provided scripts to get or set the active workspace.

Frequently Asked Questions about workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set the active workspace for my Python automation agent?

To set the active workspace for your Python automation agent, run the provided set_workspace.py script from the agent root directory. This updates the active_skill_workspace value within your skill-config.json file.

What is agent workspace path resolution used for in multi-project engagements?

Agent workspace path resolution locates the engagement root directory so that outputs, plans, and corpus data live under a consistent path rather than inside the agent package. It uses skill-config.json to manage this root for cross-project work.

How do I get the current workspace path in my local agent development environment?

To get the current workspace path in local agent development, run the get_workspace.py script. It reads the active_skill_workspace property from skill-config.json to resolve and return the engagement root.

Do I need a skill-config.json file to manage my agent's active workspace?

Yes, you need a skill-config.json file containing a workspace object to manage your agent's active workspace. The provided Python scripts read and update the active_skill_workspace property within this configuration file.

Why are my agent engagement outputs saving inside the package directory instead of the workspace?

Agent engagement outputs save inside the package directory when the active workspace is not set. Configuring the active_skill_workspace in skill-config.json resolves the engagement root and redirects artifacts to the correct path.