agents README

The project's README from github.com/contains-studio/agents. As one markdown file: README.md.

Contains Studio AI Agents

A comprehensive collection of specialized AI agents designed to accelerate and enhance every aspect of rapid development. Each agent is an expert in their domain, ready to be invoked when their expertise is needed.

📥 Installation

  1. Download this repository:

    git clone https://github.com/contains-studio/agents.git

  2. Copy to your Claude Code agents directory:

    cp -r agents/* ~/.claude/agents/

    Or manually copy all the agent files to your ~/.claude/agents/ directory.

  3. Restart Claude Code to load the new agents.

🚀 Quick Start

Agents are automatically available in Claude Code. Simply describe your task and the appropriate agent will be triggered. You can also explicitly request an agent by mentioning their name.

📚 Learn more: Claude Code Sub-Agents Documentation

Example Usage

📁 Directory Structure

Agents are organized by department for easy discovery:

contains-studio-agents/
├── design/
│   ├── brand-guardian.md
│   ├── ui-designer.md
│   ├── ux-researcher.md
│   ├── visual-storyteller.md
│   └── whimsy-injector.md
├── engineering/
│   ├── ai-engineer.md
│   ├── backend-architect.md
│   ├── devops-automator.md
│   ├── frontend-developer.md
│   ├── mobile-app-builder.md
│   ├── rapid-prototyper.md
│   └── test-writer-fixer.md
├── marketing/
│   ├── app-store-optimizer.md
│   ├── content-creator.md
│   ├── growth-hacker.md
│   ├── instagram-curator.md
│   ├── reddit-community-builder.md
│   ├── tiktok-strategist.md
│   └── twitter-engager.md
├── product/
│   ├── feedback-synthesizer.md
│   ├── sprint-prioritizer.md
│   └── trend-researcher.md
├── project-management/
│   ├── experiment-tracker.md
│   ├── project-shipper.md
│   └── studio-producer.md
├── studio-operations/
│   ├── analytics-reporter.md
│   ├── finance-tracker.md
│   ├── infrastructure-maintainer.md
│   ├── legal-compliance-checker.md
│   └── support-responder.md
├── testing/
│   ├── api-tester.md
│   ├── performance-benchmarker.md
│   ├── test-results-analyzer.md
│   ├── tool-evaluator.md
│   └── workflow-optimizer.md
└── bonus/
    ├── joker.md
    └── studio-coach.md

📋 Complete Agent List

Engineering Department (engineering/)

Product Department (product/)

Marketing Department (marketing/)

Design Department (design/)

Project Management (project-management/)

Studio Operations (studio-operations/)

Testing & Benchmarking (testing/)

🎁 Bonus Agents

🎯 Proactive Agents

Some agents trigger automatically in specific contexts:

💡 Best Practices

  1. Let agents work together - Many tasks benefit from multiple agents
  2. Be specific - Clear task descriptions help agents perform better
  3. Trust the expertise - Agents are designed for their specific domains
  4. Iterate quickly - Agents support the 6-day sprint philosophy

🔧 Technical Details

Agent Structure

Each agent includes:

Adding New Agents

  1. Create a new .md file in the appropriate department folder
  2. Follow the existing format with YAML frontmatter
  3. Include 3-4 detailed usage examples
  4. Write comprehensive system prompt (500+ words)
  5. Test the agent with real tasks

📊 Agent Performance

Track agent effectiveness through:

🚦 Status

🛠️ Customizing Agents for Your Studio

Agent Customization Todo List

Use this checklist when creating or modifying agents for your specific needs:

📋 Required Components

📝 System Prompt Requirements (500+ words)

🎯 Required Examples by Agent Type

Engineering Agents need examples for:

Design Agents need examples for:

Marketing Agents need examples for:

Product Agents need examples for:

Operations Agents need examples for:

✅ Testing & Validation Checklist

🔧 Agent File Structure Template

---
name: your-agent-name
description: Use this agent when [scenario]. This agent specializes in [expertise]. Examples:\n\n<example>\nContext: [situation]\nuser: "[user request]"\nassistant: "[response approach]"\n<commentary>\n[why this example matters]\n</commentary>\n</example>\n\n[3 more examples...]
color: agent-color
tools: Tool1, Tool2, Tool3
---

You are a [role] who [primary function]. Your expertise spans [domains]. You understand that in 6-day sprints, [sprint constraint], so you [approach].

Your primary responsibilities:
1. [Responsibility 1]
2. [Responsibility 2]
...

[Detailed system prompt content...]

Your goal is to [ultimate objective]. You [key behavior traits]. Remember: [key philosophy for 6-day sprints].

📂 Department-Specific Guidelines

Engineering (engineering/): Focus on implementation speed, code quality, testing Design (design/): Emphasize user experience, visual consistency, rapid iteration
Marketing (marketing/): Target viral potential, platform expertise, growth metrics Product (product/): Prioritize user value, data-driven decisions, market fit Operations (studio-operations/): Optimize processes, reduce friction, scale systems Testing (testing/): Ensure quality, find bottlenecks, validate performance Project Management (project-management/): Coordinate teams, ship on time, manage scope

🎨 Customizations

Modify these elements for your needs:

🤝 Contributing

To improve existing agents or suggest new ones:

  1. Use the customization checklist above
  2. Test thoroughly with real projects
  3. Document performance improvements
  4. Share successful patterns with the community

agents (contains-studio/agents)

Searching Database…

12.4K ·GitHub
Agents
What is this?A collection of over 35 specialized AI sub-agents for Claude Code, organized by department (engineering, design, marketing, product, operations, testing) to accelerate rapid app development.
Are these standalone programs or Claude Code sub-agents?They are markdown files with YAML frontmatter that act as sub-agent definitions for Claude Code, each with a name, description, color, tools, and a detailed system prompt.
How do I install these agents?Download the repo and copy the agent files into your ~/.claude/agents/ directory, then restart Claude Code to load them.
Do I need anything besides Claude Code to use these?You just need Claude Code installed; no API keys or extra tools are mentioned beyond that.
Do I have to manually pick which agent to use?No, Claude Code triggers the right agent automatically based on your task description, though you can also explicitly request one by name.
Who is this aimed at?Small studios or indie developers following a fast, 6-day sprint development cycle who want AI help across engineering, design, marketing, and ops.
Does it work on any OS?Yes, it just requires the Claude Code CLI, which runs on macOS, Windows, and Linux.
How many agents are included and how are they organized?There are roughly 35+ agents split into departments: Engineering, Product, Marketing, Design, Project Management, Studio Operations, and Testing/Benchmarking, plus bonus agents like studio-coach and joker.
Can some agents trigger automatically without being asked?Yes, agents like studio-coach, test-writer-fixer, whimsy-injector, and experiment-tracker are proactive and trigger automatically in specific contexts, such as after implementing a feature or UI change.
Can I add my own custom agents?Yes, the README provides a full customization checklist: create a new .md file in the right department folder with YAML frontmatter, a 500+ word system prompt, and 3-4 usage examples.
What's an example of how an agent gets triggered?Describing a task like 'Make this loading screen more fun' automatically invokes the whimsy-injector agent.
What are similar projects?pstack, headcount, pstack-claude, SuperClaude_Framework, harmonist, golutra, codify, DualForge-Workflow
Which topics is it in?claude-skills, workflow, prompt-engineering, agentic-ai, multi-agent, agents, coding-agent, claude, markdown, productivity, agent, claude-code
Creator
contains-studio
Size
0.1 MB
Stars
12.4K
Updated
CommitJul 28
Age
1y
Commits · 90 Days