AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Proposal Generation

skill-joellewis-finance-skills-proposal-generation · by JoelLewis

Generate end-to-end investment proposals covering risk profiling, model portfolio recommendation, fee illustration, projections, and compliance review. Use when the user asks about creating a proposal for a prospect, mapping risk questionnaire scores to model portfolios, building fee illustrations with tiered costs, producing Monte Carlo or scenario projections, analyzing a prospect's current por…

No reviews yet
0 installs
3 views
0.0% view→install

Install

$ agentstack add skill-joellewis-finance-skills-proposal-generation

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • Prompt-injection patterns
  • Secret / credential exfiltration
  • Dangerous shell & filesystem operations
  • Untrusted network calls
  • Known-malicious package signatures

What it can access

  • Network access No
  • Filesystem access No
  • Shell / process execution No
  • Environment & secrets No
  • Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-joellewis-finance-skills-proposal-generation)

Reliability & compatibility

Security review passed
0 installs to date
no reviews yet
1mo ago

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Proposal Generation? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Proposal Generation

Core Concepts

Proposal Workflow Architecture

The investment proposal is the centerpiece of the advisory sales process. It translates a prospect's financial situation and goals into a specific, actionable investment recommendation. The end-to-end workflow proceeds through defined stages:

  1. Discovery meeting — the advisor meets with the prospect to understand their financial situation, goals, concerns, and expectations. The advisor collects current account statements, tax returns, and any existing financial plan. The discovery meeting establishes the advisory relationship's tone and sets expectations for the proposal.
  2. Data collection and organization — the advisor or operations team enters prospect data into the proposal system: personal information, current holdings (manually or via account aggregation), financial goals, time horizons, income, expenses, tax situation, and any unique circumstances (concentrated positions, restricted stock, estate planning needs).
  3. Risk profiling — the prospect completes a risk tolerance questionnaire. The system scores the responses and produces a risk profile that maps to a position on the firm's risk-return spectrum. The risk profile is the bridge between subjective client preferences and objective portfolio construction.
  4. Model portfolio selection — the risk profile score maps to a specific model portfolio from the firm's lineup. The advisor reviews the mapping, considers any client-specific factors that might warrant adjustment (tax sensitivity, income needs, ESG preferences, concentrated positions), and confirms the recommended model.
  5. Current portfolio analysis — if the prospect has existing investments, the system analyzes their current holdings: asset allocation, risk metrics, expense ratios, tax lots, concentrated positions, overlap, and style drift. This analysis quantifies the gap between the current portfolio and the recommended model.
  6. Proposal document generation — the system assembles the proposal document from templates, populating it with client-specific data, the recommended portfolio, fee schedule, projections, and disclaimers. The proposal document is the deliverable that the prospect reviews and uses to make their decision.
  7. Compliance review — before the proposal is presented, it undergoes supervisory review to verify suitability documentation, performance presentation compliance, fee disclosure adequacy, and proper disclaimers. For firms subject to the SEC Marketing Rule, proposals that include performance data require additional scrutiny.
  8. Presentation and discussion — the advisor presents the proposal to the prospect, walks through the analysis and recommendation, answers questions, and addresses concerns. The presentation meeting is where the advisory value proposition is demonstrated.
  9. Revision and finalization — based on the prospect's feedback, the advisor may revise the recommendation (different model, adjusted allocation, modified fee structure) and regenerate the proposal.
  10. Acceptance and onboarding — the prospect accepts the proposal by signing the advisory agreement (IMA or similar). The proposal data flows into the onboarding process: account opening, funding, and initial investment in the recommended model.

The workflow is iterative, not strictly linear. Prospects may request multiple revisions, ask for comparisons between different models, or bring additional assets into scope after the initial proposal. The proposal system must support version tracking and efficient regeneration.

Risk Profiling and Model Mapping

Risk profiling is the foundation of the proposal recommendation. The risk questionnaire produces a quantitative score that determines which model portfolio is appropriate for the prospect.

Risk questionnaire design:

  • Questionnaires typically contain 10-25 questions assessing both willingness (behavioral/emotional tolerance for loss) and capacity (financial ability to absorb losses without jeopardizing goals).
  • Common question formats include: scenario-based loss tolerance ("If your portfolio lost 20% in a month, would you sell, hold, or buy more?"), time horizon assessment, income stability evaluation, and investment experience self-assessment.
  • Scoring produces a numerical result (e.g., 1-100) or a categorical classification (Conservative, Moderately Conservative, Moderate, Moderately Aggressive, Aggressive).
  • Third-party risk profiling tools (Riskalyze/Nitrogen, Tolerisk, FinaMetrica) provide validated, statistically tested questionnaires with defensible scoring methodologies. These are preferred over home-built questionnaires because they have undergone psychometric validation and are widely accepted by regulators.

Model portfolio lineup design: A typical advisory firm maintains 5-10 model portfolios spanning the risk-return spectrum:

| Risk Score Range | Model Name | Equity/Fixed Income | Expected Return Range | Expected Max Drawdown | |-----------------|------------|--------------------|-----------------------|----------------------| | 1-20 | Conservative Income | 20/80 | 3-5% | -8 to -12% | | 21-35 | Moderate Conservative | 35/65 | 4-6% | -12 to -18% | | 36-50 | Moderate | 50/50 | 5-7% | -18 to -25% | | 51-65 | Moderate Growth | 65/35 | 6-8% | -25 to -32% | | 66-80 | Growth | 80/20 | 7-9% | -32 to -40% | | 81-100 | Aggressive Growth | 95/5 | 8-11% | -40 to -50% |

Each model is defined by a strategic asset allocation with target weights and permissible ranges for each asset class, along with specific fund or ETF selections that implement the allocation. Models should be reviewed and rebalanced on a defined schedule (typically quarterly or semi-annually).

Suitability alignment: The risk profile alone does not determine the recommendation. The advisor must also consider:

  • Time horizon — a young investor with a long horizon may be profiled as moderate but could reasonably be placed in a growth model, while a retiree with the same risk score needs more conservative positioning due to sequence-of-returns risk.
  • Income needs — a prospect requiring portfolio income may need a model tilted toward income-producing assets, regardless of risk score.
  • Tax sensitivity — a taxable account may warrant a tax-managed version of the model (municipal bonds, tax-loss harvesting overlay, low-turnover equity strategies).
  • Concentrated positions — a prospect with a large single-stock position may need a transition strategy rather than an immediate full model assignment.
  • ESG preferences — if the prospect has environmental, social, or governance preferences, the firm may offer ESG-screened variants of its standard models.

Documenting the recommendation rationale: The proposal must articulate why this specific model is appropriate for this prospect. The rationale should reference the risk profile score, the model's risk-return characteristics, and how the recommendation aligns with the prospect's stated objectives, time horizon, and constraints. This documentation serves both as a client communication tool and as a suitability record for compliance purposes.

Proposal Document Components

A complete investment proposal typically includes the following sections:

Executive summary — a one-page overview of the recommendation: who the client is, what is being recommended, why it is appropriate, and the expected outcome. The executive summary is often the only page some decision-makers read in detail; it must be clear and compelling.

Client profile recap — a summary of the prospect's financial situation as understood by the advisor: personal information, financial goals, time horizon, risk profile score and interpretation, income and expense summary, tax situation, and any special circumstances. This section demonstrates that the advisor listened during discovery and correctly understands the prospect's needs.

Current portfolio analysis (if applicable) — for prospects with existing investments, this section provides:

  • Holdings list with current market values
  • Asset allocation breakdown (pie chart and table) compared to the recommended allocation
  • Risk metrics: portfolio standard deviation, beta, Sharpe ratio, maximum drawdown estimate
  • Expense analysis: weighted average expense ratio, total annual cost in dollars
  • Concentrated position identification: any single holding exceeding 5-10% of the portfolio
  • Style analysis: Morningstar style box mapping, factor exposures
  • Income analysis: current yield, income projection
  • Tax lot summary: unrealized gains and losses, short-term vs long-term, estimated tax impact of liquidation

Recommended portfolio — the core of the proposal:

  • Asset allocation targets with visual representation (pie chart, bar chart)
  • Holdings list: each fund or ETF, its asset class role, expense ratio, target weight, and dollar amount
  • Risk-return profile of the recommended portfolio: expected return, standard deviation, Sharpe ratio, maximum drawdown estimate
  • Comparison table: current portfolio vs recommended portfolio on key metrics
  • Income projection: expected yield and annual income from the recommended portfolio

Fee schedule — a complete disclosure of all costs the client will bear (see Fee Illustration section below).

Historical performance context — how the recommended model or a similar allocation has performed historically. This section requires careful attention to compliance (see Performance Projections and Disclaimers section below). Common presentations include:

  • Historical returns of the model portfolio (if a track record exists) or a blended benchmark representing the target allocation
  • Calendar-year returns showing both up and down years
  • Growth of $1 million chart over a trailing period (e.g., 10 or 20 years)
  • Performance during specific market events (2008-2009 crisis, 2020 COVID drawdown, 2022 rate shock)

Scenario projections — forward-looking analysis showing potential outcomes:

  • Monte Carlo simulation results: probability of meeting the client's goal, median outcome, 10th percentile (bad case), 90th percentile (good case)
  • Straight-line projections at expected return (with explicit disclaimer that this is illustrative only)
  • Stress test scenarios: how the portfolio would perform in a repeat of historical crises

Disclaimers and disclosures — required legal language (see Compliance Review section below).

Next steps — a clear call to action: sign the advisory agreement, fund the account, and begin investing. Include a timeline for implementation.

Fee Illustration

The fee illustration section of the proposal must present costs clearly, completely, and in compliance with fee disclosure requirements. Prospects make decisions based on fees; incomplete or misleading fee disclosure undermines trust and creates regulatory risk.

Advisory fee presentation:

  • Present the firm's fee schedule with all tiers and breakpoints. For a tiered schedule, show both the marginal rate at each tier and the blended (effective) rate for the prospect's specific asset level.
  • Example tiered fee schedule illustration for a $2M portfolio:

| Tier | Rate | Assets in Tier | Fee for Tier | |------|------|---------------|-------------| | First $500K | 1.00% | $500,000 | $5,000 | | Next $500K | 0.85% | $500,000 | $4,250 | | Next $1M | 0.75% | $1,000,000 | $7,500 | | Total | Blended: 0.8375% | $2,000,000 | $16,750/year |

  • Show the fee in both percentage and dollar terms. Dollar amounts are more tangible to prospects. (Reg BI requires disclosure of material fees and costs but does not prescribe dollar-amount illustrations; presenting dollar figures is a best practice for making the disclosure concrete.)
  • Specify billing frequency (quarterly in advance or arrears) and the per-quarter dollar amount.

Fund-level expense disclosure (fee-on-fee):

  • Disclose the weighted average expense ratio of the funds in the recommended portfolio.
  • Show the total annual cost combining advisory fees and fund expenses.
  • Example: Advisory fee 0.84% + weighted average fund expense ratio 0.12% = total annual cost 0.96%, or $19,200 on a $2M portfolio.
  • For proposals recommending funds-of-funds or wrap programs with underlying fund costs, the layered fee structure must be made transparent.

Total cost of ownership:

  • Beyond advisory fees and fund expenses, disclose any other costs: custodian fees, transaction costs (if applicable), account maintenance fees, wire fees, and any other charges.
  • Present a single "all-in" annual cost figure and percentage so the prospect can compare to alternatives.

Breakpoint analysis:

  • If the prospect's assets are near a fee tier breakpoint, show the impact of consolidating additional assets to reach the next lower rate.
  • Example: "At your current $475,000, your blended rate is 1.00%. By consolidating an additional $25,000, your blended rate drops to 0.985%, saving approximately $75 per year. At $1,000,000, your blended rate is 0.925%."

Fee comparison vs alternatives:

  • Prospects often compare advisory fees to robo-advisors, self-directed brokerage, or other advisory firms. The proposal may include a comparison showing the additional services provided for the advisory fee (financial planning, tax management, behavioral coaching, rebalancing).
  • Be factual and avoid disparaging competitors. Focus on value delivered rather than competitor shortcomings.

Reg BI cost disclosure requirements:

  • For broker-dealers making recommendations, Reg BI requires that the cost disclosure be specific to the recommendation, not generic. The prospect must be able to understand the total cost of the specific securities and account type being recommended.
  • The Disclosure Obligation under Reg BI requires written disclosure of all material fees and costs, including indirect compensation (12b-1 fees, revenue sharing).

Performance Projections and Disclaimers

Performance presentation in proposals is one of the most compliance-sensitive areas of the advisory business. The SEC Marketing Rule (Rule 206(4)-1 under the Advisers Act, effective November 2022) substantially governs how investment advisers present performance.

Is a proposal "advertising"? Under the Marketing Rule, "advertisement" includes any communication to more than one person (or designed for such use) that offers or promotes advisory services. A one-on-one proposal to a specific prospect is generally not an advertisement if it is truly tailored to that individual. However, if the firm uses a standardized proposal template that is distributed broadly with only minor customization, regulators may view it as advertising. Best practice: treat all performance presentations in proposals as if the Marketing Rule applies, even for one-on-one presentations.

Historical performance presentation:

  • If presenting actual model portfolio track records, the Marketing Rule requires: gross and net-of-fee performance shown with equal prominence, a disclosure of whether the performance reflects actual client accounts or a model/hypothetical, the time period covered, and material conditions or assumptions.
  • If presenting index or benchmark returns as a proxy for the recommended allocation, clearly label them as benchmark returns, not the firm's performance. Disclose that the benchmark is not directly investable and does not reflect fees, trading costs, or taxes.

Hypothetical performance:

  • The Marketing Rule permits hypothetical performance (including backtested model portfolios) in one-on-one presentations, provided the adviser adopts policies and procedures reasonably designed to ensure the performance is relevant to the recipient's financial situation and investment objectives, and the adviser provides sufficient information for the recipient to understand the assumptions and limitations.
  • Required disclosures for hypothetical

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Versions

  • v0.1.0 Imported from the upstream source.