Client Report

---
name: client-report
description: "Use this skill when the task requires client report capabilities."
executor: LLM_BEHAVIOR
skill_id: finance.wealth_management.client_report_3
status: ADOPTED
security: {level: high, pii: false, approval_required: true}
anchors:
  - finance
  - reporting
  - performance
  - design
tier: 2
input_schema:
  - name: code_or_task
    type: string
    description: "Code snippet, script, or task description to process"
    required: true
output_schema:
  - name: report
    type: string
    description: "Analysis report or summary from client report"
---
# Client Report

description: Generate professional client-facing performance reports with portfolio returns, allocation breakdowns, and market commentary. Suitable for quarterly or annual distribution. Triggers on "client report", "performance report", "quarterly report for [client]", "generate reports", or "client statement".

## Workflow

### Step 1: Report Parameters

- **Client name** and household
- **Reporting period**: Quarter, YTD, annual, custom range
- **Accounts**: All accounts or specific account
- **Benchmark**: S&P 500, 60/40 blend, custom benchmark matching IPS
- **Firm branding**: Logo, colors, disclaimers

### Step 2: Performance Summary

**Household Summary:**

| | QTD | YTD | 1-Year | 3-Year Ann. | 5-Year Ann. | ITD Ann. |
|---|-----|-----|--------|-------------|-------------|----------|
| Portfolio | | | | | | |
| Benchmark | | | | | | |
| +/- | | | | | | |

**By Account:**

| Account | Type | Value | QTD | YTD | Benchmark |
|---------|------|-------|-----|-----|-----------|
| Joint Taxable | Brokerage | | | | |
| John IRA | Traditional | | | | |
| Jane Roth | Roth IRA | | | | |
| 529 Plan | Education | | | | |
| **Total** | | | | | |

### Step 3: Allocation Overview

Current allocation with visual (pie chart or bar chart):

| Asset Class | % of Portfolio | $ Value | Benchmark % |
|------------|---------------|---------|-------------|
| | | | |

### Step 4: Holdings Detail

| Security | Asset Class | Shares | Price | Value | % of Portfolio | QTD Return |
|----------|-----------|--------|-------|-------|---------------|-----------|
| | | | | | | |

### Step 5: Market Commentary

Brief market summary tailored to the client's level of sophistication:
- What happened in markets this quarter (2-3 sentences)
- How it affected the portfolio
- Outlook and positioning rationale (2-3 sentences)
- No jargon for retail clients; can be more technical for sophisticated investors

### Step 6: Activity Summary

- Trades executed during the period
- Contributions and withdrawals
- Dividends and interest received
- Fees charged
- Rebalancing activity

### Step 7: Planning Notes

- Progress toward financial goals (retirement, education, etc.)
- Any plan changes or recommendations
- Upcoming action items
- Next review date

### Step 8: Output

- PDF report (8-12 pages) with firm branding
- Word document for customization
- Excel data appendix (optional)

**Report Structure:**
1. Cover page (client name, period, firm logo)
2. Executive summary (1 page)
3. Performance summary (1-2 pages)
4. Allocation overview with charts (1 page)
5. Holdings detail (1-2 pages)
6. Market commentary (1 page)
7. Activity summary (1 page)
8. Planning notes (1 page)
9. Disclosures and disclaimers (1 page)

## Important Notes

- Performance must be calculated net of fees unless client/compliance requires gross
- Always include appropriate disclaimers and disclosures (past performance, risk factors)
- Reports should be consistent across clients — use a standard template
- Match the level of detail to the client — some want every holding, others want a one-page summary
- Benchmark selection matters — use the benchmark from the IPS, not whatever looks best
- Review for compliance approval before first distribution of a new template

---

## Why This Skill Exists

Generate professional client-facing performance reports with portfolio returns, allocation breakdowns, and market commentary. Suitable for quarterly or annual distribution. Triggers on "client report", "performance report", "quarterly report for [client]", "generate reports", or "client statement".

<!-- SR_40: auto-generated from frontmatter `purpose`/`description` (OPP-Phase3). Expand with domain-specific rationale. -->

## When to Use

Use this skill when the task requires client report capabilities.

<!-- SR_40: auto-generated from frontmatter `when`/`description` (OPP-Phase3). -->

## What If Fails

If this skill fails to produce the expected output: (1) verify input completeness, (2) retry with more specific context, (3) fall back to the parent workflow without this skill.

<!-- SR_40: auto-generated from frontmatter `what_if_fails` (OPP-Phase3). -->