Skip to content
Back to search

maia-skill

Tododeia — Multi-agent investment analysis system for market research, portfolio recommendations, and interactive reporting across crypto, stocks, forex, and commodities.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hainrixz--maia-skill/badge.svg)](/listings/hainrixz--maia-skill)

HTML

<a href="/listings/hainrixz--maia-skill"><img src="/api/listings/hainrixz--maia-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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

# 2. Symlink skill into Claude Code
mkdir -p ~/.claude/skills
ln -s "$(pwd)/maia-skill/.claude/skills/investment-analysis" ~/.claude/skills/investment-analysis

# 3. Install dashboard dependencies
npm install --prefix maia-skill/dashboard

The skill auto-activates when you mention investment-related topics in Claude Code.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "maia-skill",
  3. "version": "2.1.0",
  4. "description": "Tododeia — Multi-agent investment analysis system for market research, portfolio recommendations, and interactive reporting across crypto, stocks, forex, and commodities.",
  5. "author": {
  6. "name": "soyenriquerocha",
  7. "url": "https://github.com/Hainrixz"
  8. },
  9. "homepage": "https://github.com/Hainrixz/maia-skill#readme",
  10. "repository": "https://github.com/Hainrixz/maia-skill",
  11. "license": "MIT",
  12. "keywords": ["investment", "analysis", "trading", "market-research", "finance", "crypto", "stocks", "forex", "commodities", "tododeia"],
  13. "skills": "./.claude/skills/"
  14. }
README.md · README · 510 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <a id="top"></a>
  2. <p align="center">
  3. <img src="docs/images/hero.png" alt="MAIA — five AI research agents converging into a market analysis dashboard" width="100%">
  4. </p>
  5. <h1 align="center">MAIA System</h1>
  6. <p align="center">
  7. <strong>M</strong>ulti-<strong>A</strong>gent <strong>I</strong>nvestment <strong>A</strong>nalysis — for Claude Code<br>
  8. Five specialized AI agents research crypto, stocks, forex &amp; commodities in parallel, adapt to your risk profile, and render an interactive, bilingual dashboard — <em>educational analysis, not financial advice.</em>
  9. </p>
  10. <p align="center">
  11. <img alt="version 2.1.0" src="https://img.shields.io/badge/version-2.1.0-3a8c1a">
  12. <img alt="Claude Code skill" src="https://img.shields.io/badge/Claude%20Code-skill-3a8c1a">
  13. <img alt="Next.js 16" src="https://img.shields.io/badge/Next.js-16-111111">
  14. <img alt="TypeScript strict" src="https://img.shields.io/badge/TypeScript-strict-111111">
  15. <img alt="license MIT" src="https://img.shields.io/badge/license-MIT-3a8c1a">
  16. <img alt="EN / ES bilingual" src="https://img.shields.io/badge/EN%20%2F%20ES-bilingual-111111">
  17. </p>
  18. <p align="center"><strong><a href="#espanol">Leer en Español ↓</a></strong> · by tododeia · <a href="https://github.com/Hainrixz">@soyenriquerocha</a></p>
  19. ---
  20. > **What's new in v2.1** — hybrid **keyless** market-data APIs (CoinGecko · Yahoo Finance · Frankfurter) with optional premium keys, an educational acknowledgment gate, a security-hardened dashboard (CSP + XSS-safe HTML fallback), full accessibility (ARIA, keyboard nav, reduced-motion), a numeric data contract validated in CI, and portable runs from any directory. See the [CHANGELOG](CHANGELOG.md).
  21. ---
  22. ## What Is This?
  23. MAIA 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.
  24. ## How It Works
  25. ```
  26. ┌──────────────┐
  27. ┌────┤ You trigger ├────┐
  28. │ │ "analyze │ │
  29. │ │ markets" │ │
  30. │ └──────────────┘ │
  31. ▼ ▼
  32. ┌──────────────┐ ┌──────────────┐
  33. │ Risk Profile │ │ Load History │
  34. │ Question │ │ (if exists) │
  35. └──────┬───────┘ └──────┬───────┘
  36. │ │
  37. ▼ │
  38. ┌──────────────────────────────┐ │
  39. │ 4 Sector Agents │ │
  40. │ (parallel web research) │ │
  41. │ │ │
  42. │ ┌───────┐ ┌───────┐ │ │
  43. │ │Crypto │ │Stocks │ │ │
  44. │ └───────┘ └───────┘ │ │
  45. │ ┌───────┐ ┌──────────┐ │ │
  46. │ │ Forex │ │Materials │ │ │
  47. │ └───────┘ └──────────┘ │ │
  48. └──────────────┬───────────────┘ │
  49. │ │
  50. ▼ ▼
  51. ┌────────────────────────────────────┐
  52. │ Strategy Agent │
  53. │ (cross-sector analysis, │
  54. │ risk-adjusted ranking, │
  55. │ portfolio allocation, │
  56. │ historical accuracy check) │
  57. └────────────────┬───────────────────┘
  58. │
  59. ┌──────┴──────┐
  60. ▼ ▼
  61. ┌────────────┐ ┌────────────┐
  62. │ report.json│ │report-es │
  63. │ (English) │ │ .json │
  64. └──────┬─────┘ └──────┬─────┘
  65. │ │
  66. ▼ ▼
  67. ┌──────────────────────┐
  68. │ Next.js Dashboard │
  69. │ localhost:3420 │
  70. │ EN / ES toggle │
  71. └──────────────────────┘
  72. ```
  73. ## Features
  74. <p align="center">
  75. <img src="docs/images/dashboard.png" alt="The MAIA dashboard: allocation donut, recommendation cards, performance and risk-analysis charts" width="100%">
  76. </p>
  77. - **5 AI agents** — 4 sector researchers + 1 strategy synthesizer, running in parallel
  78. - **Hybrid market data** — authoritative prices from free **keyless** APIs (CoinGecko, Yahoo Finance, Frankfurter) with a deterministic fallback ladder; WebSearch adds news & sentiment. Optional `FINNHUB_API_KEY` / `POLYGON_API_KEY` for premium stock data
  79. - **Dynamic asset discovery** — agents find the most relevant assets for current conditions instead of a fixed list
  80. - **Risk profiles** — conservative / moderate / aggressive reshape scoring, illustrative position sizes, and allocation
  81. - **Cross-sector strategy** — a synthesis agent surfaces correlations and divergences individual agents can't see
  82. - **Historical accuracy tracking** — compares prior signals to outcomes over time (a local heuristic, not an audited record)
  83. - **Interactive dashboard** — allocation donut, risk-vs-confidence and social-buzz charts, expandable per-asset tables, top-picks grid
  84. - **Fully bilingual (EN/ES)** — UI *and* report data translate on toggle; numbers, tickers and prices stay intact
  85. - **Educational-first compliance** — a one-time "not financial advice" gate before the report; analytical *Consider / Hold / Avoid* language instead of buy/sell
  86. - **Accessible** — ARIA-labeled charts, keyboard-navigable cards & sortable tables, focus-visible rings, `prefers-reduced-motion`
  87. - **Secure & private** — Content-Security-Policy + security headers; XSS-hardened HTML fallback; runs locally with data kept in `~/.claude/cache/tododeia`
  88. - **Portable** — resolves its own install directory and writes to a writable cache, so it works from any folder
  89. - **Scheduling** — optional daily or weekly recurring reports
  90. ## Sectors Covered
  91. | Sector | Always Includes | Dynamically Discovers |
  92. |--------|----------------|----------------------|
  93. | Crypto | BTC, ETH | Trending altcoins, DeFi tokens, AI tokens |
  94. | Stocks | S&P 500, NASDAQ | Top movers, catalyst-driven stocks across sectors |
  95. | Forex | DXY, USD/MXN | Pairs affected by current events |
  96. | Commodities | Gold, Oil WTI | Agricultural, energy, metals based on market conditions |
  97. ## Requirements
  98. - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (CLI)
  99. - Node.js 18+ for the interactive dashboard — **optional**; without it the skill renders a standalone HTML report (served with `python3`)
  100. - An internet connection (agents fetch live prices and do web research)
  101. - *Optional:* `FINNHUB_API_KEY` or `POLYGON_API_KEY` for premium stock data — free keyless sources are used by default
  102. ## Installation
  103. ### Option A: One-liner (fastest)
  104. ```bash
  105. curl -sL https://raw.githubusercontent.com/Hainrixz/maia-skill/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 127 on GitHub
  106. ```
  107. This clones the repo, symlinks the skill into Claude Code, and installs dashboard dependencies automatically.
  108. ### Option B: Claude Code plugin
  109. ```bash
  110. claude plugin install Hainrixz/maia-skill
  111. ```
  112. ### Option C: Manual setup
  113. ```bash
  114. # 1. Clone the repo
  115. git clone https://github.com/Hainrixz/maia-skill.git
  116. # 2. Symlink skill into Claude Code
  117. mkdir -p ~/.claude/skills
  118. ln -s "$(pwd)/maia-skill/.claude/skills/investment-analysis" ~/.claude/skills/investment-analysis
  119. # 3. Install dashboard dependencies
  120. npm install --prefix maia-skill/dashboard
  121. ```
  122. The skill auto-activates when you mention investment-related topics in Claude Code.
  123. ## Usage
  124. In any Claude Code conversation:
  125. - "Run an investment analysis"
  126. - "What are the best investment opportunities today?"
  127. - "Analyze the markets"
  128. - "Give me a market report"
  129. - "Run tododeia"
  130. You'll be asked your risk profile (conservative, moderate, or aggressive), then the 5 agents go to work. The report opens at `http://localhost:3420`. On first open you'll acknowledge a short *educational, not advice* notice and pick a language. Generated reports are written to `~/.claude/cache/tododeia` — not your current project folder.
  131. ### Language Toggle
  132. <p align="center">
  133. <img src="docs/images/bilingual.png" alt="Full English / Spanish bilingual support" width="46%">
  134. </p>
  135. When you first open the dashboard, you'll be asked to pick English or Spanish. All report content — summaries, reasoning, news headlines, insights, warnings — translates to your chosen language. Numbers, prices, tickers, and percentages stay as-is. If a Spanish report isn't available yet, the dashboard shows English with a small notice instead of failing.
  136. You can switch languages anytime from the toolbar.
  137. ### Scheduling (Optional)
  138. After your first report, you can set up recurring analysis:
  139. ```
  140. /loop 24h /investment-analysis # Daily reports
  141. /loop 168h /investment-analysis # Weekly reports
  142. ```
  143. ## Project Structure
  144. ```
  145. .claude/skills/investment-analysis/
  146. SKILL.md # Skill definition (orchestrator instructions)
  147. assets/
  148. template.html # Fallback HTML report (no Node.js)
  149. references/
  150. agent-prompts.md # Prompts for all 5 agents
  151. dashboard/ # Next.js interactive dashboard
  152. src/
  153. app/ # App router pages
  154. components/ # Report UI components
  155. hooks/ # Language + data hooks
  156. lib/ # Translations, constants
  157. types/ # TypeScript types
  158. public/data/ # Sample report JSON (demo fixtures; live runs write to ~/.claude/cache/tododeia)
  159. schema/ # JSON Schema for the report data contract (CI-validated)
  160. ```
  161. ## Customization
  162. ### Assets & Agent Behavior
  163. Edit `references/agent-prompts.md` to change which assets each agent researches, how they search, or what data they prioritize.
  164. ### Risk Profiles
  165. The Strategy Agent prompt in `references/agent-prompts.md` defines how each risk profile affects scoring and allocation. Customize the multipliers and allocation ranges there.
  166. ### Dashboard Styling
  167. The dashboard uses Tailwind CSS. Edit components in `dashboard/src/components/report/` to change the look and feel.
  168. ### Translations
  169. Add or modify UI translations in `dashboard/src/lib/translations.ts`. Report data translation happens automatically via the translation agent (Step 8b in SKILL.md).
  170. ## Dashboard Features
  171. - **Executive summary** with macro environment assessment
  172. - **Portfolio allocation** chart with recommended percentages
  173. - **Risk-adjusted top picks** grid with confidence scores and position sizing
  174. - **Cross-sector insights** highlighting correlations between markets
  175. - **Expandable sector panels** with detailed per-asset analysis
  176. - **Charts**: allocation breakdown, risk vs. confidence visualization
  177. - **Historical accuracy** tracking past recommendation performance
  178. - **Risk warnings** when the strategy agent detects concerns
  179. - **Full bilingual support** — English and Spanish, including all data
  180. ## Fallback Mode
  181. If Node.js is not available, the skill falls back to a standalone `report.html` (in `~/.claude/cache/tododeia/output`) built from the template in `assets/`, served via Python's built-in HTTP server on port 8420 (`python3`, falling back to `python`). Report data is embedded as an inert JSON island and every web-sourced string is HTML-escaped, so untrusted headlines or posts can't inject scripts.
  182. ## Educational Use & Disclaimer
  183. <p align="center">
  184. <img src="docs/images/educational.png" alt="Educational analysis, not financial advice — transparent, AI-assisted research" width="70%">
  185. </p>
  186. Before the report renders, the dashboard shows a one-time acknowledgment ("this is educational, not financial advice") and the disclaimer stays visible at the top. Signals are phrased analytically (*Consider / Hold / Avoid*), never as buy/sell instructions.
  187. **This is educational analysis, not financial advice.** MAIA's signals and allocations are AI-generated opinions derived from public data — they may be wrong, out of date, or incomplete, and are not a recommendation or solicitation to buy or sell any asset. AI analysis can contain errors. Always do your own research and consult a licensed financial advisor before investing. Past performance is not indicative of future results. **You assume all investment risk.**
  188. **Data & limitations.** Prices come from free public APIs (CoinGecko, Yahoo Finance, Frankfurter) with a web-search fallback, so they may lag the market and some instruments fall back to search estimates. The "historical accuracy" metric is a local heuristic, not an audited track record. Set `FINNHUB_API_KEY` or `POLYGON_API_KEY` for higher-quality stock data (free keyless sources are used otherwise).
  189. **Privacy.** Reports are generated and served on your machine only — runtime data is written to `~/.claude/cache/tododeia`, never committed to the repo. Do **not** expose the dashboard to the public internet; it has no authentication.
  190. ---
  191. <a id="espanol"></a>
  192. <p align="center">
  193. <img src="docs/images/hero.png" alt="MAIA — cinco agentes de IA convergiendo en un dashboard de analisis de mercado" width="100%">
  194. </p>
  195. <h1 align="center">MAIA System</h1>
  196. <p align="center">
  197. <strong>M</strong>ulti-<strong>A</strong>gent <strong>I</strong>nvestment <strong>A</strong>nalysis — para Claude Code<br>
  198. Cinco agentes de IA especializados investigan crypto, acciones, forex y materias primas en paralelo, se adaptan a tu perfil de riesgo y renderizan un dashboard interactivo y bilingue — <em>analisis educativo, no asesoria financiera.</em>
  199. </p>
  200. <p align="center"><strong><a href="#top">Read in English ↑</a></strong> · por tododeia · <a href="https://github.com/Hainrixz">@soyenriquerocha</a></p>
  201. ---
  202. > **Novedades v2.1** — APIs de mercado **sin clave** (CoinGecko · Yahoo Finance · Frankfurter) con claves premium opcionales, gate de reconocimiento educativo, dashboard endurecido (CSP + HTML de respaldo a prueba de XSS), accesibilidad completa (ARIA, teclado, movimiento reducido), contrato de datos numerico validado en CI, y ejecucion portatil desde cualquier carpeta. Ver el [CHANGELOG](CHANGELOG.md).
  203. ---
  204. ## Que es esto?
  205. MAIA es un **skill de Claude Code** — un paquete reutilizable de prompts y herramientas que extiende lo que Claude puede hacer. Una vez instalado, Claude puede ejecutar un flujo completo de investigacion de inversiones con multiples agentes: 4 analistas sectoriales investigan en paralelo, un agente estrategico sintetiza todo, y el resultado se sirve como un dashboard interactivo en tu navegador.
  206. ## Como funciona
  207. ```
  208. ┌──────────────┐
  209. ┌────┤ Tu escribes ├────┐
  210. │ │ "analiza │ │
  211. │ │ mercados" │ │
  212. │ └──────────────┘ │
  213. ▼ ▼
  214. ┌──────────────┐ ┌──────────────┐
  215. │Perfil Riesgo │ │Cargar Histor.│
  216. │ Pregunta │ │ (si existe) │
  217. └──────┬───────┘ └──────┬───────┘
  218. │ │
  219. ▼ │
  220. ┌──────────────────────────────┐ │
  221. │ 4 Agentes Sectoriales │ │
  222. │ (investigacion en paralelo) │ │
  223. │ │ │
  224. │ ┌───────┐ ┌──────────┐ │ │
  225. │ │Crypto │ │Acciones │ │ │
  226. │ └───────┘ └──────────┘ │ │
  227. │ ┌───────┐ ┌──────────┐ │ │
  228. │ │ Forex │ │Mat.Primas│ │ │
  229. │ └───────┘ └──────────┘ │ │
  230. └──────────────┬───────────────┘ │
  231. │ │
  232. ▼ ▼
  233. ┌────────────────────────────────────┐
  234. │ Agente de Estrategia │
  235. │ (analisis inter-sectorial, │
  236. │ ranking ajustado por riesgo, │
  237. │ asignacion de portafolio, │
  238. │ verificacion de precision) │
  239. └────────────────┬───────────────────┘
  240. │
  241. ┌──────┴──────┐
  242. ▼ ▼
  243. ┌────────────┐ ┌────────────┐
  244. │ report.json│ │report-es │
  245. │ (Ingles) │ │ .json │
  246. └──────┬─────┘ └──────┬─────┘
  247. │ │
  248. ▼ ▼
  249. ┌──────────────────────┐
  250. │ Dashboard Next.js │
  251. │ localhost:3420 │
  252. │ EN / ES toggle │
  253. └──────────────────────┘
  254. ```
  255. ## Caracteristicas
  256. <p align="center">
  257. <img src="docs/images/dashboard.png" alt="El dashboard de MAIA: dona de asignacion, tarjetas de recomendacion, graficos de rendimiento y riesgo" width="100%">
  258. </p>
  259. - **5 agentes IA** — 4 investigadores sectoriales + 1 sintetizador de estrategia, en paralelo
  260. - **Datos de mercado hibridos** — precios autoritativos desde APIs **sin clave** (CoinGecko, Yahoo Finance, Frankfurter) con escalera de respaldo determinista; WebSearch aporta noticias y sentimiento. Claves opcionales `FINNHUB_API_KEY` / `POLYGON_API_KEY` para datos premium de acciones
  261. - **Descubrimiento dinamico** — encuentran los activos mas relevantes segun las condiciones actuales, no una lista fija
  262. - **Perfiles de riesgo** — conservador / moderado / agresivo reconfiguran el scoring, los tamanos ilustrativos de posicion y la asignacion
  263. - **Estrategia inter-sectorial** — un agente sintetizador revela correlaciones y divergencias que los agentes individuales no ven
  264. - **Seguimiento de precision historica** — compara senales previas con resultados (heuristica local, no un historial auditado)
  265. - **Dashboard interactivo** — dona de asignacion, graficos de riesgo y actividad social, tablas por activo expandibles, grid de top picks
  266. - **Totalmente bilingue (EN/ES)** — interfaz *y* datos del reporte se traducen al cambiar idioma; numeros, tickers y precios intactos
  267. - **Cumplimiento educativo primero** — gate de "no es asesoria financiera" antes del reporte; lenguaje analitico *Considerar / Mantener / Evitar* en vez de comprar/vender
  268. - **Accesible** — graficos con ARIA, tarjetas y tablas operables por teclado, anillos de foco visibles, `prefers-reduced-motion`
  269. - **Seguro y privado** — Content-Security-Policy + headers de seguridad; HTML de respaldo a prueba de XSS; corre localmente y los datos quedan en `~/.claude/cache/tododeia`
  270. - **Portatil** — resuelve su propio directorio de instalacion y escribe en un cache, asi funciona desde cualquier carpeta
  271. - **Programacion** — reportes recurrentes diarios o semanales opcionales
  272. ## Sectores Cubiertos
  273. | Sector | Siempre Incluye | Descubre Dinamicamente |
  274. |--------|----------------|----------------------|
  275. | Crypto | BTC, ETH | Altcoins en tendencia, tokens DeFi, tokens IA |
  276. | Acciones | S&P 500, NASDAQ | Mayores movimientos, acciones con catalizadores |
  277. | Forex | DXY, USD/MXN | Pares afectados por eventos actuales |
  278. | Materias Primas | Oro, Petroleo WTI | Agricolas, energia, metales segun condiciones |
  279. ## Requisitos
  280. - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (CLI)
  281. - Node.js 18+ para el dashboard interactivo — **opcional**; sin el, el skill genera un reporte HTML independiente (servido con `python3`)
  282. - Conexion a internet (los agentes traen precios en vivo e investigan en la web)
  283. - *Opcional:* `FINNHUB_API_KEY` o `POLYGON_API_KEY` para datos premium de acciones — por defecto se usan fuentes gratuitas sin clave
  284. ## Instalacion
  285. ### Opcion A: Una sola linea (la mas rapida)
  286. ```bash
  287. curl -sL https://raw.githubusercontent.com/Hainrixz/maia-skill/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 372 on GitHub
  288. ```
  289. Esto clona el repo, enlaza el skill a Claude Code e instala las dependencias del dashboard automaticamente.
  290. ### Opcion B: Plugin de Claude Code
  291. ```bash
  292. claude plugin install Hainrixz/maia-skill
  293. ```
  294. ### Opcion C: Configuracion manual
  295. ```bash
  296. # 1. Clonar el repo
  297. git clone https://github.com/Hainrixz/maia-skill.git
  298. # 2. Enlazar el skill en Claude Code
  299. mkdir -p ~/.claude/skills
  300. ln -s "$(pwd)/maia-skill/.claude/skills/investment-analysis" ~/.claude/skills/investment-analysis
  301. # 3. Instalar dependencias del dashboard
  302. npm install --prefix maia-skill/dashboard
  303. ```
  304. El skill se activa automaticamente cuando mencionas temas de inversion en Claude Code.
  305. ## Uso
  306. En cualquier conversacion de Claude Code:
  307. - "Ejecuta un analisis de inversiones"
  308. - "Cuales son las mejores oportunidades de inversion hoy?"
  309. - "Analiza los mercados"
  310. - "Dame un reporte de mercado"
  311. - "Corre tododeia"
  312. Se te preguntara tu perfil de riesgo (conservador, moderado o agresivo), luego los 5 agentes se ponen a trabajar. El reporte se abre en `http://localhost:3420`. Al abrirlo por primera vez reconoceras un breve aviso *educativo, no asesoria* y elegiras idioma. Los reportes generados se escriben en `~/.claude/cache/tododeia` — no en la carpeta de tu proyecto.
  313. ### Cambio de Idioma
  314. <p align="center">
  315. <img src="docs/images/bilingual.png" alt="Soporte bilingue completo ingles / espanol" width="46%">
  316. </p>
  317. Cuando abras el dashboard por primera vez, se te pedira elegir ingles o espanol. Todo el contenido del reporte — resumenes, razonamientos, titulares, insights, advertencias — se traduce al idioma elegido. Los numeros, precios, tickers y porcentajes se mantienen igual. Si aun no hay reporte en espanol, el dashboard muestra ingles con un aviso en vez de fallar.
  318. Puedes cambiar de idioma en cualquier momento desde la barra de herramientas.
  319. ### Programacion (Opcional)
  320. Despues de tu primer reporte, puedes configurar analisis recurrentes:
  321. ```
  322. /loop 24h /investment-analysis # Reportes diarios
  323. /loop 168h /investment-analysis # Reportes semanales
  324. ```
  325. ## Estructura del Proyecto
  326. ```
  327. .claude/skills/investment-analysis/
  328. SKILL.md # Definicion del skill (instrucciones del orquestador)
  329. assets/
  330. template.html # Reporte HTML de respaldo (sin Node.js)
  331. references/
  332. agent-prompts.md # Prompts para los 5 agentes
  333. dashboard/ # Dashboard interactivo en Next.js
  334. src/
  335. app/ # Paginas del App Router
  336. components/ # Componentes del reporte
  337. hooks/ # Hooks de idioma y datos
  338. lib/ # Traducciones, constantes
  339. types/ # Tipos de TypeScript
  340. public/data/ # JSON del reporte generado (se crea en ejecucion)
  341. ```
  342. ## Personalizacion
  343. ### Activos y Comportamiento de Agentes
  344. Edita `references/agent-prompts.md` para cambiar que activos investiga cada agente, como buscan, o que datos priorizan.
  345. ### Perfiles de Riesgo
  346. El prompt del Agente de Estrategia en `references/agent-prompts.md` define como cada perfil de riesgo afecta la puntuacion y asignacion. Personaliza los multiplicadores y rangos de asignacion ahi.
  347. ### Estilos del Dashboard
  348. El dashboard usa Tailwind CSS. Edita los componentes en `dashboard/src/components/report/` para cambiar la apariencia.
  349. ### Traducciones
  350. Agrega o modifica traducciones de la interfaz en `dashboard/src/lib/translations.ts`. La traduccion de datos del reporte ocurre automaticamente a traves del agente de traduccion (Paso 8b en SKILL.md).
  351. ## Caracteristicas del Dashboard
  352. - **Resumen ejecutivo** con evaluacion del entorno macro
  353. - **Asignacion de portafolio** con porcentajes recomendados
  354. - **Top picks ajustados por riesgo** con puntuaciones de confianza y tamano de posicion
  355. - **Insights inter-sectoriales** destacando correlaciones entre mercados
  356. - **Paneles sectoriales expandibles** con analisis detallado por activo
  357. - **Graficos**: desglose de asignacion, visualizacion de riesgo vs. confianza
  358. - **Precision historica** rastreando el rendimiento de recomendaciones pasadas
  359. - **Alertas de riesgo** cuando el agente de estrategia detecta preocupaciones
  360. - **Soporte bilingue completo** — ingles y espanol, incluyendo todos los datos
  361. ## Modo de Respaldo
  362. Si Node.js no esta disponible, el skill genera un `report.html` independiente (en `~/.claude/cache/tododeia/output`) usando la plantilla en `assets/`, servido por el servidor HTTP de Python en el puerto 8420 (`python3`, con respaldo a `python`). Los datos del reporte se incrustan como un bloque JSON inerte y cada texto traido de la web se escapa, asi que titulares o publicaciones no confiables no pueden inyectar scripts.
  363. ## Uso Educativo y Aviso Legal
  364. <p align="center">
  365. <img src="docs/images/educational.png" alt="Analisis educativo, no asesoria financiera — investigacion transparente asistida por IA" width="70%">
  366. </p>
  367. Antes de renderizar el reporte, el dashboard muestra un reconocimiento unico ("esto es educativo, no asesoria financiera") y el aviso permanece visible arriba. Las senales se expresan de forma analitica (*Considerar / Mantener / Evitar*), nunca como instrucciones de comprar/vender.
  368. **Esto es analisis educativo, no asesoria financiera.** Las senales y asignaciones de MAIA son opiniones generadas por IA a partir de datos publicos — pueden estar equivocadas, desactualizadas o incompletas, y no son una recomendacion ni solicitud para comprar o vender ningun activo. El analisis con IA puede contener errores. Haz siempre tu propia investigacion y consulta a un asesor financiero licenciado antes de invertir. El rendimiento pasado no es indicativo de resultados futuros. **Asumes todo el riesgo de inversion.**
  369. **Datos y limitaciones.** Los precios provienen de APIs publicas gratuitas (CoinGecko, Yahoo Finance, Frankfurter) con respaldo de busqueda web, por lo que pueden ir por detras del mercado y algunos instrumentos recurren a estimaciones de busqueda. La "precision historica" es una heuristica local, no un historial auditado. Define `FINNHUB_API_KEY` o `POLYGON_API_KEY` para mejores datos de acciones (por defecto se usan fuentes gratuitas sin clave).
  370. **Privacidad.** Los reportes se generan y sirven solo en tu maquina — los datos de ejecucion se escriben en `~/.claude/cache/tododeia`, nunca en el repo. **No** expongas el dashboard a internet publico; no tiene autenticacion.
  371. ## Licencia
  372. MIT — ver [LICENSE](LICENSE)
  373. ## Contribuir
  374. Codigo abierto. PRs son bienvenidos!
  375. <!-- marca-agua:inicio -->
  376. ---
  377. <sub>Hecho por **Enrique Rocha (@soyenriquerocha)** · [tododeia.com](https://www.tododeia.com)⁠​‌‌​​‌​‌​‌‌‌​​‌​​​‌​‌‌​‌​​‌‌‌​​​​​‌‌​​​​​​‌‌​‌​‌​‌‌​​​‌‌​​‌‌‌​​‌​‌‌​​​‌​​​‌‌​‌‌‌​​‌‌​​‌‌⁠</sub>
  378. <!-- marca-agua:fin -->
install.sh · Bundled script · 87 lines · 2 findings marked
  1. #!/usr/bin/env bash
  2. # Copyright (c) 2026 Enrique Rocha (@soyenriquerocha)
  3. # SPDX-License-Identifier: MIT
  4. # id: er-805c9b73
  5. # Tododeia / MAIA Skill — Installer
  6. # Usage: curl -sL https://raw.githubusercontent.com/Hainrixz/maia-skill/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 6 on GitHub
  7. set -euo pipefail
  8. REPO="https://github.com/Hainrixz/maia-skill.git"
  9. SKILL_NAME="investment-analysis"
  10. INSTALL_DIR="$HOME/.claude/skills/$SKILL_NAME"
  11. CLONE_DIR="$HOME/.claude/plugins/maia-skill"
  12. RETRY="rm -rf \"$INSTALL_DIR\" \"$CLONE_DIR\" && curl -sL https://raw.githubusercontent.com/Hainrixz/maia-skill/main/install.sh | bash"
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 14 on GitHub
  13. CREATED_THIS_RUN=0
  14. cleanup() {
  15. if [ "$CREATED_THIS_RUN" = "1" ]; then
  16. echo " Installation failed — removing partial install..."
  17. rm -rf "$CLONE_DIR" "$INSTALL_DIR"
  18. fi
  19. echo " To retry: $RETRY"
  20. }
  21. trap cleanup ERR INT
  22. echo ""
  23. echo " Tododeia — Multi-Agent Investment Analysis"
  24. echo " by @soyenriquerocha"
  25. echo ""
  26. # Repair a dangling symlink, or update an existing install.
  27. if [ -L "$INSTALL_DIR" ] && [ ! -e "$INSTALL_DIR" ]; then
  28. echo " Repairing broken skill symlink..."
  29. rm -f "$INSTALL_DIR"
  30. elif [ -d "$CLONE_DIR/.git" ]; then
  31. echo " Already installed — updating..."
  32. if git -C "$CLONE_DIR" pull --quiet; then
  33. echo " Updated successfully."
  34. else
  35. echo " WARNING: 'git pull' failed; existing install left untouched."
  36. fi
  37. echo ""
  38. trap - ERR INT
  39. exit 0
  40. fi
  41. # Clone (only if not already present).
  42. echo " Cloning skill..."
  43. mkdir -p "$HOME/.claude/plugins"
  44. if [ ! -d "$CLONE_DIR/.git" ]; then
  45. CREATED_THIS_RUN=1
  46. git clone --quiet "$REPO" "$CLONE_DIR"
  47. fi
  48. # Symlink the skill into Claude Code's skills directory (-n avoids dereferencing an existing dir symlink).
  49. mkdir -p "$HOME/.claude/skills"
  50. ln -sfn "$CLONE_DIR/.claude/skills/$SKILL_NAME" "$INSTALL_DIR"
  51. # Install dashboard dependencies if Node is available (non-fatal — HTML fallback works without it).
  52. if command -v npm >/dev/null 2>&1; then
  53. echo " Installing dashboard dependencies..."
  54. if npm install --prefix "$CLONE_DIR/dashboard" --no-audit --no-fund; then
  55. echo " Dashboard ready."
  56. else
  57. echo " WARNING: dashboard dependency install failed (see output above)."
  58. echo " The skill will use the HTML fallback report instead."
  59. fi
  60. else
  61. echo " Node.js not found — the skill will use the HTML fallback report."
  62. echo " Install Node.js 18+ for the interactive dashboard."
  63. command -v python3 >/dev/null 2>&1 || echo " Note: the HTML fallback server needs python3 (not found)."
  64. fi
  65. trap - ERR INT
  66. CREATED_THIS_RUN=0
  67. echo ""
  68. echo " Installed successfully!"
  69. echo ""
  70. echo " Optional: set FINNHUB_API_KEY or POLYGON_API_KEY for premium stock data."
  71. echo " (Free keyless sources — CoinGecko, Yahoo, Frankfurter — are used by default.)"
  72. echo ""
  73. echo " Open Claude Code and say:"
  74. echo " \"Run an investment analysis\" | \"Analiza los mercados\" | \"Run tododeia\""
  75. echo ""
  76. echo " To uninstall: rm -rf \"$INSTALL_DIR\" \"$CLONE_DIR\""
  77. echo ""

Version history

  • v2.1.010/25/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.