agent-env

Initialize or repair workspace agent environments for Claude Code and Copilot.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jeff-hamm/ai-tools --skill agent-env
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-env
Source: https://github.com/jeff-hamm/ai-tools/tree/main/src/skills/agent-env
Command: npx skills add https://github.com/jeff-hamm/ai-tools --skill agent-env

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, git, and includes scripts (resource) components.

What problem does it solve?

Initialize or repair the AI agent environment for a workspace or git repo so Claude Code and Copilot cooperate out of the box. Run any time you start a new workspace, clone a repo, or find that instructions/agents aren't being picked up. Use for "init workspace", "new project setup", "claude code vscode not cooperating", "setup agents", "wire up .claude", "agent environment", "repair agent config", or any request to give Claude/Copilot workspace-specific agents, skills, rules, or hooks.

Core Features & Use Cases

  • Create and link real .agents/ and .claude/ directories with proper symlinks to ensure discovery.
  • Generate or update AGENTS.md and VS Code settings to enable workspace-level agents, rules, hooks, prompts, and skills.
  • Support optional Cursor, MCP, and profile setups and repair drift in existing workspaces.

Quick Start

Run the agent-env script to initialize or repair the workspace agent environment.

Frequently Asked Questions about agent-env

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

FAQPage Schema
How do I set up a workspace agent environment for Claude Code and Copilot?

To set up a workspace agent environment, you need to initialize or repair the .agents/ and .claude/ directories. This process creates proper symlinks and updates VS Code settings so Claude Code and Copilot can discover workspace-specific agents, rules, and hooks.

Why is Claude Code not discovering my workspace agents and rules?

Claude Code fails to discover workspace agents and rules when the agent environment drifts or is uninitialized. Running an environment repair script relinks the .agents/ and .claude/ directories and regenerates AGENTS.md to restore proper discovery.

Do I need git and python3 to initialize my AI agent workspace configuration?

Yes, you need git and python3 installed to initialize your AI agent workspace configuration. The setup script relies on python3 to execute the initialization logic and git to manage the repository workspace structure and symlinks.

Can I configure Cursor and MCP servers when setting up my workspace agents?

Yes, you can configure Cursor and MCP servers when setting up your workspace agents. The initialization process supports optional Cursor, MCP, and profile setups alongside the core Claude Code and Copilot integration features.

What is the best way to wire up .claude directory settings for a new project?

The best way to wire up the .claude directory for a new project is to run an agent environment initialization script. This automatically generates the .claude/ folder, creates necessary symlinks to .agents/, and updates VS Code settings for immediate agent cooperation.

When should I repair agent config drift in my git repository?

You should repair agent config drift in your git repository immediately after cloning or when instructions and agents are not being picked up by your tools. Repairing relinks the .agents/ and .claude/ directories and updates AGENTS.md to fix discovery.