agents

Shared Cursor rules, commands, skills, and docs distributed as standalone git repos.

Repository Structure

agents/
├── commands/   # UserGeneratedLLC/agent-commands
├── skills/     # UserGeneratedLLC/agent-skills
├── rules/      # UserGeneratedLLC/agent-rules
└── docs/       # UserGeneratedLLC/agent-docs

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/UserGeneratedLLC/agents/master/install.sh | bash

Windows (PowerShell):

iex "& { $(irm https://raw.githubusercontent.com/UserGeneratedLLC/agents/master/install.ps1) }"

Repos are cloned to .cursor/{rules,skills,docs,commands}/usergenerated and updated hourly via cron (Linux/macOS) or scheduled task (Windows). Run the update script manually any time:

.cursor/update-usergenerated.sh

.cursor/update-usergenerated.ps1

Per-Project Install

To add shared agents to a single project (instead of installing globally), add them as git submodules. Run these from the project root — pick all four or only the ones you need:

git submodule add https://github.com/UserGeneratedLLC/agent-rules.git .cursor/rules/usergenerated
git submodule add https://github.com/UserGeneratedLLC/agent-commands.git .cursor/commands/usergenerated
git submodule add https://github.com/UserGeneratedLLC/agent-skills.git .cursor/skills/usergenerated
git submodule add https://github.com/UserGeneratedLLC/agent-docs.git .cursor/docs/usergenerated

After cloning a project that already has these submodules, initialize them:

git submodule update --init --recursive

Pull the latest upstream changes for all submodules:

git submodule update --remote --merge --recursive

Uninstall

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/UserGeneratedLLC/agents/master/install.sh | bash -s -- uninstall

Windows (PowerShell):

iex "& { $(irm https://raw.githubusercontent.com/UserGeneratedLLC/agents/master/install.ps1) } -Action uninstall"

Guidelines for Changes

Every file here is consumed across multiple projects. Keep rules, commands, and skills general-purpose, prefer additive changes, and use clear naming.

Submodule Workflow

Each subdirectory is an independent git submodule. Commit inside the submodule first, then update the parent:

git submodule update --remote --merge --recursive
git add <submodule-dir>
git commit -m "update <submodule> to latest"