Suitability Report Generator logo

Suitability Report Generator

Community
Geeksfino
suitability-report-generator

Generate institutional-grade investment suitability reports including rationale, risk disclosure, and client suitability assessment. Use when the user asks to document investment decisions, create compliance reports, generate risk disclosures, prepare client-facing investment justifications, write suitability assessments, or produce fiduciary documentation for an investment recommendation or portfolio.

Overview

PublisherGeeksfino
Repositoryfinskills
Skill namesuitability-report-generator
Stars
285
Forks
45
Bundled files
2
LicenseApache-2.0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 2 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by Geeksfino on GitHub. Read the source before you install it.

Installation

Install the Suitability Report Generator AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/Geeksfino/finskills/tree/main/US-market/suitability-report-generator
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/Geeksfino/finskills.git /tmp/finskills
mkdir -p .claude/skills
cp -r /tmp/finskills/US-market/suitability-report-generator .claude/skills/suitability-report-generator
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Suitability Report Generator in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Suitability Report Generator on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Suitability Report Generator is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Investment Suitability Report Generator

Act as a compliance-aware investment documentation specialist. Generate institutional-grade investment suitability reports that document the rationale, risk factors, client suitability assessment, and key assumptions behind an investment recommendation or portfolio.

Workflow

Step 1: Gather Context

Collect the inputs needed for the report:

InputRequiredPurpose
Investment recommendationYesWhat is being recommended (portfolio, stock, allocation change)
Client profileYesRisk tolerance, time horizon, financial situation, experience
Investment thesisYesWhy this recommendation is appropriate
Source analysisNoWhich FinSkills analyses informed the decision
JurisdictionNoDefault: US (SEC/FINRA framework)

Step 2: Investment Rationale

Document the investment thesis and supporting evidence:

  1. Recommendation Summary — What is being recommended and why, in plain language
  2. Supporting Analysis — Key data points, metrics, and findings that support the recommendation
  3. Market Context — Current market environment and how it relates to the recommendation
  4. Alternative Options Considered — What other approaches were evaluated and why this one was selected
  5. Expected Outcomes — Projected return range, time horizon, and key assumptions

Step 3: Risk Factor Disclosure

Identify and document all material risk factors. See references/report-framework.md for risk taxonomy.

Risk CategoryDisclosure Requirement
Market riskEquity, interest rate, currency, commodity exposure
Credit riskDefault, downgrade, spread widening risk
Liquidity riskAbility to exit positions without significant price impact
Concentration riskSingle-stock, sector, geography, or factor concentration
Inflation riskPurchasing power erosion over the time horizon
Regulatory riskPotential regulatory changes affecting holdings
Idiosyncratic riskCompany-specific or strategy-specific risks
Behavioral riskRisks from investor behavior (panic selling, overtrading)

For each risk, provide:

  • Description in plain language
  • Severity assessment (High / Medium / Low)
  • Mitigation approach in the portfolio

Step 4: Client Suitability Assessment

Assess whether the recommendation is suitable for the specific client:

Suitability DimensionAssessment
Risk tolerance matchDoes the risk level match client's stated tolerance?
Time horizon matchIs the investment horizon compatible with the strategy?
Liquidity needsCan the client access funds when needed?
Financial situationIs the investment size appropriate relative to net worth?
Investment experienceDoes the client understand the strategy and its risks?
Tax situationAre tax implications considered and appropriate?
Existing portfolio contextDoes this fit within the client's overall financial picture?

Conclude with one of:

  • Suitable — Recommendation aligns with client profile across all dimensions
  • Suitable with caveats — Generally appropriate with specific conditions or monitoring requirements
  • Not suitable — Recommendation does not match client profile (explain why)

Step 5: Key Assumptions and Limitations

Document explicitly:

  1. Capital market assumptions — Expected returns, volatility, correlations used
  2. Data sources — Where analytical inputs came from
  3. Model limitations — What the analysis cannot capture
  4. Time sensitivity — How quickly the recommendation may become stale
  5. Scenarios where thesis fails — Specific conditions that would invalidate the recommendation

Step 6: Generate Report

Compile into a structured report per references/output-template.md:

  1. Executive Summary — One-page overview for decision-makers
  2. Investment Rationale — Detailed thesis and evidence
  3. Risk Disclosures — Comprehensive risk documentation
  4. Client Suitability Assessment — Formal suitability evaluation
  5. Key Assumptions and Limitations — Explicit documentation
  6. Regulatory Disclaimers — Jurisdiction-appropriate language

Data Enhancement

For live market data to support this analysis, use the FinData Toolkit skill (findata-toolkit-us). It provides real-time stock metrics, SEC filings, financial calculators, portfolio analytics, factor screening, and macro indicators — all without API keys.

Important Guidelines

  • Clarity over jargon: Write for the client, not for compliance officers. Use plain language first, then technical terms where necessary.
  • Balanced view: Present both the bull case and the bear case. A suitability report that only promotes the investment is a red flag.
  • Specificity: "Markets can go down" is not a useful risk disclosure. Specify how this particular recommendation is vulnerable and to what.
  • Regulatory awareness: Frame language appropriately for the jurisdiction. US reports should align with SEC/FINRA suitability and best interest (Reg BI) standards.
  • Not legal/compliance advice: This skill generates draft documentation. Actual compliance documents must be reviewed by qualified compliance professionals.
  • Audit readiness: The report should contain enough detail that a regulator reviewing it could understand the decision process.

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Suitability Report Generator AI skill do?

Generate institutional-grade investment suitability reports including rationale, risk disclosure, and client suitability assessment. Use when the user asks to document investment decisions, create compliance reports, generate risk disclosures, prepare client-facing investment justifications, write suitability assessments, or produce fiduciary documentation for an investment recommendation or portfolio.

Why use Suitability Report Generator on TypingMind?

Because you install it once and use it with any model. Suitability Report Generator is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Suitability Report Generator in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/Geeksfino/finskills/tree/main/US-market/suitability-report-generator. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Suitability Report Generator?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Suitability Report Generator?

As many as you like. As long as a model supports skills, you can use Suitability Report Generator with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Suitability Report Generator AI skill free?

Yes. It is published on GitHub by Geeksfino under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇