Install Unity Agent Skills

Install the skills once per project. Your AI assistant discovers them automatically and activates the right skill when you mention debugging topics.

Claude Code

Clone into your project's skills directory:

git clone https://github.com/jahro-console/unity-agent-skills.git .agents/skills/jahro

Claude Code discovers skills in .agents/skills/ automatically. No further configuration needed.

Shared installation — clone once, symlink into each project:

git clone https://github.com/jahro-console/unity-agent-skills.git ~/jahro-agent-skills
ln -s ~/jahro-agent-skills .agents/skills/jahro

Cursor

Copy skill files into Cursor's rules directory:

git clone https://github.com/jahro-console/unity-agent-skills.git /tmp/jahro-skills
 
# Copy each skill as a rule
for skill in /tmp/jahro-skills/skills/*/SKILL.md; do
  name=$(basename $(dirname "$skill"))
  cp "$skill" ".cursor/rules/${name}.md"
done
 
# Copy reference files
mkdir -p .cursor/rules/jahro-references
cp /tmp/jahro-skills/references/*.md .cursor/rules/jahro-references/
 
rm -rf /tmp/jahro-skills

In Cursor Settings → Rules, mark jahro-setup.md as Always so it provides context for all Jahro-related queries. Leave other skill rules as Auto — Cursor activates them based on your prompt.

Other AI assistants

Place the skills/ and references/ directories anywhere your assistant scans for markdown context files. Most assistants with project-level context support pick up SKILL.md files automatically.

Verify installation

After installing, test with a simple prompt:

"Add a debug command to reset the game state"

Your AI should generate a [JahroCommand] attribute with the correct parameter order (name, group, description), use static for standalone commands, and include RegisterObject lifecycle if the method is on a MonoBehaviour.

If the AI generates generic code without Jahro attributes, it hasn't found the skills. Verify the file paths match your assistant's expected context directories.

Updating

cd .agents/skills/jahro
git pull

Skills are versioned alongside Jahro releases. The CHANGELOG documents what changed in each version.

What gets installed

unity-agent-skills/
├── skills/
│   ├── jahro-logging/SKILL.md      # Structured logging (standalone)
│   ├── jahro-setup/SKILL.md        # Project detection & installation
│   ├── jahro-commands/SKILL.md     # Runtime commands
│   ├── jahro-watcher/SKILL.md      # Variable monitoring
│   ├── jahro-snapshots/SKILL.md    # Bug capture & sharing
│   ├── jahro-production/SKILL.md   # Production safety
│   ├── jahro-troubleshooting/SKILL.md  # Diagnostics
│   └── jahro-migration/SKILL.md    # Migrate from other tools
├── references/
│   ├── api-reference.md            # Complete Jahro API (~14KB)
│   └── common-patterns.md          # Reusable code patterns (~9KB)
└── evals/                          # Quality testing scenarios

Each skill is self-contained. You can install only the skills you need by copying individual SKILL.md files instead of the full repository.

Gotchas

  • Git must be installed for the git clone command. If you installed Unity via Unity Hub, Git is likely already on your system.
  • Cursor rules directory: if .cursor/rules/ doesn't exist, create it before running the copy script.
  • Skill activation is automatic. You don't need to mention "use the commands skill" — the AI reads each skill's description field and activates when your prompt matches.
  • Skills require Jahro 1.0.0-beta6+. If you're on an older version, the generated code may reference APIs that don't exist yet. Update your Jahro package first.

Frequently Asked Questions

Can I install skills globally instead of per-project? Yes. Clone to a shared location (e.g., ~/jahro-agent-skills) and symlink into each project. For Claude Code, symlink to .agents/skills/jahro. For Cursor, you'll need to copy the files since Cursor reads from .cursor/rules/ per project.

Do I need to install all 8 skills? No. Each skill is standalone. If you only want structured logging, copy just jahro-logging/SKILL.md. If you only want commands and watcher, copy those two plus the references/ folder.

What if my AI assistant isn't listed here? Any assistant that supports markdown context files will work. Place the skills and references in whatever directory your assistant scans for project context.

How often should I update the skills? Update when you update the Jahro Unity package. Skills are versioned to match Jahro releases, so they stay in sync with the API.

Last updated: April 2, 2026