> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agents-squads.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

> Real-world agent configurations you can use today

These are illustrative custom squad configs to help you design your own. See
[Configuration](https://github.com/agents-squads/squads-cli/blob/main/docs/configuration.md)
for the 4 starter squads (`intelligence`, `research`, `product`, `company`)
that ship with `squads init`.

## Market Research Squad

A custom variant of the research domain, tuned for deep-dive analysis.

```markdown theme={null}
# .agents/squads/market-research/SQUAD.md

# Market Research Squad

## Mission
Transform raw intelligence into actionable insights.

## Agents
- analyst: Deep research and competitive analysis
- writer: Content creation from research findings
- reviewer: Quality and accuracy validation

## Outputs
- research/ directory
- Weekly market reports
- Competitive analysis documents
```

<Accordion title="analyst.md">
  ```markdown theme={null}
  # Research Analyst

  ## Purpose
  Conduct deep research on markets, competitors, and trends.

  ## Inputs
  - Research topic or question
  - Scope (broad overview / deep dive)
  - Time constraints

  ## Outputs
  - Research findings in markdown
  - Source citations
  - Confidence levels for claims

  ## Instructions
  1. Clarify the research question
  2. Search for primary sources
  3. Cross-reference findings
  4. Synthesize into structured report
  5. Flag uncertainties and gaps
  ```
</Accordion>

<Accordion title="writer.md">
  ```markdown theme={null}
  # Research Writer

  ## Purpose
  Transform research findings into polished content.

  ## Inputs
  - Research report from analyst
  - Target audience
  - Format (blog post / white paper / brief)

  ## Outputs
  - Formatted document
  - Executive summary
  - Key takeaways section

  ## Instructions
  1. Review analyst findings
  2. Identify narrative structure
  3. Write for target audience
  4. Include data visualizations where helpful
  5. Add citations and sources
  ```
</Accordion>

***

## Lead Generation Squad

A custom team for prospecting and outreach — not one of the starter squads,
built from scratch with `squads add`.

```markdown theme={null}
# .agents/squads/lead-gen/SQUAD.md

# Lead Generation Squad

## Mission
Build and nurture the customer pipeline.

## Agents
- lead-researcher: Find and qualify prospects
- outreach: Craft personalized messages

## Outputs
- customer/ directory
- Lead lists
- Outreach templates
```

<Accordion title="lead-researcher.md">
  ```markdown theme={null}
  # Lead Researcher

  ## Purpose
  Identify and qualify potential customers.

  ## Inputs
  - Ideal customer profile (ICP)
  - Industry focus
  - Company size range

  ## Outputs
  - Qualified lead list
  - Company profiles
  - Contact information

  ## Instructions
  1. Search for companies matching ICP
  2. Research each company's needs
  3. Identify decision makers
  4. Score lead quality (1-5)
  5. Document reasoning
  ```
</Accordion>

***

## Engineering Squad

A team for code review and documentation.

```markdown theme={null}
# .agents/squads/engineering/SQUAD.md

# Engineering Squad

## Mission
Maintain code quality and system documentation.

## Agents
- code-reviewer: Review PRs for quality
- doc-writer: Keep documentation current
- security-scanner: Check for vulnerabilities

## Outputs
- engineering/ directory
- Code review reports
- Updated documentation
```

<Accordion title="code-reviewer.md">
  ```markdown theme={null}
  # Code Reviewer

  ## Purpose
  Review pull requests for quality, security, and best practices.

  ## Inputs
  - PR diff or file changes
  - Project coding standards
  - Context about the change

  ## Outputs
  - Review comments
  - Approval/request changes decision
  - Suggested improvements

  ## Instructions
  1. Understand the purpose of the change
  2. Check for bugs and edge cases
  3. Verify security best practices
  4. Ensure code style consistency
  5. Suggest improvements (not nitpicks)
  ```
</Accordion>

***

## Quick Templates

### Simple Task Agent

```markdown theme={null}
# Task Name

## Purpose
One sentence description.

## Inputs
- What it needs

## Outputs
- What it produces

## Instructions
1. Step one
2. Step two
3. Step three
```

### Analysis Agent

```markdown theme={null}
# Analyzer

## Purpose
Analyze [X] and provide insights.

## Inputs
- Data or document to analyze
- Analysis criteria
- Output format preference

## Outputs
- Analysis report
- Key findings (bullet points)
- Recommendations

## Instructions
1. Review input thoroughly
2. Apply analysis framework
3. Identify patterns and anomalies
4. Synthesize findings
5. Provide actionable recommendations
```

***

## GitHub Repository

Browse more examples and contribute your own:

<Card title="agents-squads/examples" icon="github" href="https://github.com/agents-squads">
  Open source agent templates and configurations
</Card>