invest-setup

Initialize openInvest deployments by collecting user profile and holdings context.

77|11|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/longsizhuo/openInvest --skill invest-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: invest-setup
Source: https://github.com/longsizhuo/openInvest/tree/main/skills/invest-setup
Command: npx skills add https://github.com/longsizhuo/openInvest --skill invest-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

It helps users turn a fresh openInvest installation into a usable, personalized investment “commission memo” workflow by collecting profile data and converting a free-form holdings description into the portfolio format the system understands.

Core Features & Use Cases

  • First-time onboarding only: Runs a dedicated setup flow when the user asks to initialize openInvest or when invest reports needs_setup.
  • Five-question user intake: Captures identity, risk tolerance, monthly budget context, and a natural-language holdings description.
  • Optional wealth context & safe fallbacks: Supports optional wealth_context to improve risk interpretation and uses DeepSeek parsing when keys are provided; otherwise it falls back to a simpler cash-only portfolio mapping.

Quick Start

Ask an AI agent with access to your skills to initialize openInvest by saying: "help me set up invest".

Frequently Asked Questions about invest-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize openInvest onboarding for a new deployment?

To initialize openInvest onboarding, execute scripts/run.sh to trigger the doctor-gated needs_setup detection flow, which collects your user profile and portfolio context for a fresh deployment. This generates a validated portfolio payload required for the system to operate.

What data is needed for investment planning setup during the intake flow?

Investment planning setup requires five intake inputs: user identity, risk tolerance, monthly budget context, and a natural-language holdings description, alongside optional wealth_context to improve risk interpretation accuracy. These inputs generate the validated portfolio payload.

Can I use DeepSeek for holdings parsing without providing API keys?

You cannot use DeepSeek parsing without keys, but the system applies a safe fallback behavior that maps your holdings into a simpler cash-only portfolio format to complete the setup process. This ensures onboarding finishes even without external API access.

When should I run the portfolio setup flow instead of regular investment commands?

Run the portfolio setup flow when the invest command reports a needs_setup status, or when portfolio memory and user_profile data is entirely missing or outdated and requires a full reset. This one-time initialization ensures your profile is correctly validated.

Does openInvest onboarding support migrating existing portfolio memory?

Onboarding initializes a fresh deployment rather than directly editing existing files, but it applies to reset scenarios where outdated portfolio memory needs complete regeneration through the validated portfolio payload. This handles both first-time setup and memory migration needs.