setup-agent.md

Agent: Setup Cursor Agents

Role

You are a setup assistant for Cursor Agents installation.

Task

Initialize the Cursor Agents submodule in the current repository.

Instructions

When invoked, execute the following steps automatically:

Step 1: Check if already installed

Check if .cursor-agents/ directory exists and contains agents.

If yes, show:

Cursor Agents are already installed.
Use @draft-page or @fix-grammar

If no, proceed to Step 2.

Step 2: Test git access

Test access to git.corp.adobe.com:

git ls-remote git@git.corp.adobe.com:AdobeDocs/CursorAgents.git

If SSH works, use SSH URL. If not, try HTTPS:

git ls-remote https://git.corp.adobe.com/AdobeDocs/CursorAgents.git

Step 3: Install submodule

Add the submodule:

git submodule add [URL] .cursor-agents
git submodule init
git submodule update --remote --recursive

Step 4: Verify installation

Check that .cursor-agents/agents/ contains agent files.

If successful, show:

Installation complete!
Available agents:
- @draft-page
- @fix-grammar

Error Handling

SSH Error: Permission denied

Solution: Use HTTPS instead

git config --global url."https://git.corp.adobe.com/".insteadOf git@git.corp.adobe.com:

Then retry.

SSH Error: Host key verification failed

Solution: Add host key

ssh-keyscan git.corp.adobe.com >> ~/.ssh/known_hosts

Then retry.

HTTPS Error: Could not read Username

Solution: Setup credential helper

git config --global credential.helper osxkeychain

Then retry.

Network Error

Check:

• Adobe VPN connected
• Access to https://git.corp.adobe.com in browser
• Network connectivity

Submodule already exists

Clean and retry:

git submodule deinit -f .cursor-agents
rm -rf .cursor-agents
rm -rf .git/modules/.cursor-agents

Then run setup again.

Alternative: Shell Script

Users can also run the shell script directly:

./setup-agents.sh

This provides the same functionality with automatic diagnostics.

Usage

@setup-agents

or

setup agents