Agents Catalog

Agents are role-based Markdown files. Claude Code has first-class support for sub-agents today. Cursor, Windsurf, and GitHub Copilot handle agents differently — see the per-tool notes below.

Quick Install

The interactive installer handles all IDE paths for you:

npx github:Desquared/agents-rules-skills install-agents

Pick your IDE(s), choose a scope (project or global), filter by platform, and the installer places files in the correct location — native agents folder for Claude Code, custom instructions for others.

Manual Install

How To Install An Agent

Claude Code

Claude Code loads agents from ~/.claude/agents/ (global) or .claude/agents/ (project-local). Each Markdown file becomes a sub-agent that Claude can automatically delegate to.

# Global (available in every project)
mkdir -p ~/.claude/agents
curl -fsSL https://raw.githubusercontent.com/Desquared/agents-rules-skills/main/agents/ios-security-reviewer.md \
  -o ~/.claude/agents/ios-security-reviewer.md

# Project-local (only available in this project)
mkdir -p .claude/agents
curl -fsSL https://raw.githubusercontent.com/Desquared/agents-rules-skills/main/agents/ios-security-reviewer.md \
  -o .claude/agents/ios-security-reviewer.md

GitHub Copilot

GitHub Copilot supports project and global agent folders.

# Global (available in every project)
mkdir -p ~/.copilot/agents
curl -fsSL https://raw.githubusercontent.com/Desquared/agents-rules-skills/main/agents/ios-security-reviewer.md \
  -o ~/.copilot/agents/ios-security-reviewer.md

# Project-local (only available in this project)
mkdir -p .github/agents
curl -fsSL https://raw.githubusercontent.com/Desquared/agents-rules-skills/main/agents/ios-security-reviewer.md \
  -o .github/agents/ios-security-reviewer.md

Cursor, Windsurf

These tools do not currently support a "drop a file = new sub-agent" pattern equivalent to Claude Code agents. Instead:

• Cursor: Use the agent files as custom instructions or rules (see RULES.md). The content works just as well as detailed system-level guidance.
• Windsurf: Paste the agent content into a Flow, or add it to a rule file (see RULES.md) for persistent context.

Agent Catalog

Flutter

• flutter-accessibility-specialist.md: Accessibility specialist for Flutter apps.
• flutter-agent-guidelines.md: Flutter Agent Guidelines.
• flutter-bug-solver.md: Scientific method expert for systematic bug investigation.
• flutter-code-reviewer.md: Code review specialist for Flutter features.
• flutter-feature-analyst.md: Feature analysis specialist.
• flutter-performance-optimizer.md: Flutter performance specialist for profiling, optimization, and efficiency.
• flutter-project-architecture-analyst.md: Architecture planner for new features.
• flutter-refactoring-specialist.md: Specialized agent for migrating legacy code to data/domain/view structure.

iOS

• ios-accessibility-specialist.md: iOS accessibility expert for VoiceOver, Dynamic Type, color contrast, and assistive technologies.
• ios-agent-guidelines.md: iOS Agent Guidelines.
• ios-build-error-resolver.md: Xcode build error specialist.
• ios-concurrency-networking-agent.md: Expert in Swift concurrency and networking.
• ios-coredata-swiftdata-specialist.md: Core Data / SwiftData specialist.
• ios-performance-optimizer.md: iOS performance specialist for profiling, optimization, and efficiency.
• ios-project-architecture-analyst.md: Architecture analyst for planning new features and core changes.
• ios-security-reviewer.md: iOS security specialist for code auditing.
• ios-swiftui-layout-specialist.md: Expert SwiftUI layout specialist for complex layouts, custom view modifiers, geometry calculations, and responsive design.
• ios-testing-qa-agent.md: Expert testing and quality assurance specialist for XCTest, UI testing, mocking strategies, test-driven development, and code coverage.
• ios-ux-ui-design-agent.md: UX/UI design specialist focused on user experience, design system compliance, user flow optimization, and modern iOS design patterns.

Android

• android-accessibility-specialist.md: Android accessibility expert for TalkBack, Dynamic Text, color contrast, and assistive technologies.
• android-agent-guidelines.md: Android Agent Discovery & Implementation Guidelines.
• android-build-error-resolver.md: Android/Gradle build error specialist.
• android-compose-layout-specialist.md: Expert Jetpack Compose layout specialist for complex layouts, custom modifiers, measurement/layout, and responsive design.
• android-concurrency-networking-agent.md: Expert in Kotlin coroutines and networking.
• android-performance-optimizer.md: Android performance specialist for profiling, optimization, and efficiency.
• android-persistence-specialist.md: Room / Realm / DataStore specialist.
• android-project-architecture-analyst.md: Architecture analyst for planning new features and core changes.
• android-security-reviewer.md: Android security specialist for code auditing.
• android-testing-qa-agent.md: Expert testing and quality assurance specialist for JUnit, Espresso, Compose UI testing, MockK, test-driven development, and code coverage.
• android-ux-ui-design-agent.md: UX/UI design specialist focused on user experience, Material Design compliance, user flow optimization, and modern Android design patterns.