joellewis/finance_skills2 files

Proposal Generation

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 portfolio for improvement opportunities, reviewing proposals for SEC Marketing Rule compliance, or designing proposal templates for a multi-advisor firm. Also trigger when users mention 'investment proposal', 'proposal generation', 'risk profiling', 'Riskalyze', 'Nitrogen', 'fee illustration', 'transition analysis', 'current vs proposed portfolio', or 'proposal compliance review'.

Specification
Skill ID
joellewis/finance_skills/proposal-generation
Publisher
joellewis
Repository
finance_skills
Installs
0
Files
2
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

joellewis/finance_skills/proposal-generationInstalls these files
  • SKILL.md
  • references/examples.md

What this skill tells the agent

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 RangeModel NameEquity/Fixed IncomeExpected Return RangeExpected Max Drawdown
1-20Conservative Income20/803-5%-8 to -12%
21-35Moderate Conservative35/654-6%-12 to -18%
36-50Moderate50/505-7%-18 to -25%
51-65Moderate Growth65/356-8%-25 to -32%
66-80Growth80/207-9%-32 to -40%
81-100Aggressive Growth95/58-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.

More from joellewis

Use this skill in a project

Open any RiverX project, search the Skills panel for joellewis/finance_skills/proposal-generation, and install it in one click.

Use this skill