maia-skill

Finance.ia — Multi-Agent Investment Analysis Skill

by @soyenriquerocha

A Claude Code skill that spawns 5 specialized AI research agents to analyze investment opportunities across crypto, stocks, forex, and commodities. Adapts to your risk profile, tracks historical accuracy, and generates an interactive Next.js dashboard with full Spanish/English support.

Leer en Espanol

---

What Is This?

Finance.ia is a Claude Code skill — a reusable prompt-and-tooling package that extends what Claude can do. When installed, Claude gains the ability to run a full multi-agent investment research workflow: 4 sector analysts research in parallel, a strategy agent synthesizes everything, and the result is served as an interactive dashboard in your browser.

How It Works

                         ┌──────────────┐
                    ┌────┤  You trigger  ├────┐
                    │    │  "analyze     │    │
                    │    │   markets"    │    │
                    │    └──────────────┘    │
                    ▼                        ▼
            ┌──────────────┐        ┌──────────────┐
            │ Risk Profile │        │ Load History  │
            │   Question   │        │  (if exists)  │
            └──────┬───────┘        └──────┬───────┘
                   │                       │
                   ▼                       │
    ┌──────────────────────────────┐       │
    │     4 Sector Agents          │       │
    │  (parallel web research)     │       │
    │                              │       │
    │  ┌───────┐  ┌───────┐       │       │
    │  │Crypto │  │Stocks │       │       │
    │  └───────┘  └───────┘       │       │
    │  ┌───────┐  ┌──────────┐   │       │
    │  │ Forex │  │Materials │   │       │
    │  └───────┘  └──────────┘   │       │
    └──────────────┬───────────────┘       │
                   │                       │
                   ▼                       ▼
          ┌────────────────────────────────────┐
          │        Strategy Agent               │
          │  (cross-sector analysis,            │
          │   risk-adjusted ranking,            │
          │   portfolio allocation,             │
          │   historical accuracy check)        │
          └────────────────┬───────────────────┘
                           │
                    ┌──────┴──────┐
                    ▼             ▼
            ┌────────────┐ ┌────────────┐
            │ report.json│ │report-es   │
            │ (English)  │ │  .json     │
            └──────┬─────┘ └──────┬─────┘
                   │              │
                   ▼              ▼
              ┌──────────────────────┐
              │   Next.js Dashboard  │
              │   localhost:3420     │
              │   EN / ES toggle    │
              └──────────────────────┘

Features

• 5 AI Agents: 4 sector researchers + 1 strategy synthesizer, all running in parallel
• Dynamic Asset Discovery: Agents don't follow a fixed list — they find the most relevant assets based on current market conditions
• Risk Profiles: Conservative, moderate, or aggressive — recommendations, position sizes, and allocations adapt to you
• Social Sentiment: Twitter/X and Reddit sentiment analysis per asset
• Source Verification: Cross-references prices from 2+ sources with agreement scoring
• Historical Accuracy: Compares past recommendations to actual outcomes over time
• Portfolio Allocation: Suggested % allocation across sectors based on your risk profile
• Cross-Sector Insights: Correlations and divergences that individual agents can't see
• Spanish/English: Full bilingual support — UI chrome AND report data translate when you toggle
• Interactive Dashboard: Charts, expandable sector analysis, top picks grid, risk warnings
• Scheduling: Option to run daily or weekly with automatic reports

Sectors Covered

Sector	Always Includes	Dynamically Discovers
Crypto	BTC, ETH	Trending altcoins, DeFi tokens, AI tokens
Stocks	S&P 500, NASDAQ	Top movers, catalyst-driven stocks across sectors
Forex	DXY, USD/MXN	Pairs affected by current events
Commodities	Gold, Oil WTI	Agricultural, energy, metals based on market conditions

Requirements

• Claude Code (CLI)
• Node.js 18+ (for the dashboard)
• Active internet connection (agents perform live web research)

Installation

Option A: One-liner (fastest)

curl -sL https://raw.githubusercontent.com/Hainrixz/maia-skill/main/install.sh | bash

This clones the repo, symlinks the skill into Claude Code, and installs dashboard dependencies automatically.

Option B: Claude Code plugin

claude plugin install Hainrixz/maia-skill

Option C: Manual setup

# 1. Clone the repo
git clone https://github.com/Hainrixz/maia-skill.git