{
  "markdown": "# 🧙 Market Sages\n\n> **13 legendary investors. One command. Zero setup.**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-Ready-blue?logo=anthropic)](https://claude.ai/code)\n[![Codex CLI](https://img.shields.io/badge/Codex%20CLI-Ready-green?logo=openai)](https://github.com/openai/codex)\n[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Ready-red?logo=google)](https://github.com/google-gemini/gemini-cli)\n\n**Market Sages** summons a council of the world's greatest investors to analyze any stock — Warren Buffett, Charlie Munger, Benjamin Graham, Michael Burry, Nassim Taleb, and 8 more. No API keys. No Python environment. No financial data subscription. Just a ticker symbol.\n\n---\n\n**[🇨🇳 中文文档](docs/i18n/README.zh-CN.md)** | **[🇯🇵 日本語](docs/i18n/README.ja.md)** | **[🇰🇷 한국어](docs/i18n/README.ko.md)**\n\n---\n\n## ✨ What It Does\n\nYou type:\n```\n/sages NVDA\n```\n\nYou get a full council deliberation:\n\n```\n╔══════════════════════════════════╗\n║  🧠 Warren Buffett               ║\n║  Signal: NEUTRAL                 ║\n║  Confidence: 55%                 ║\n║  Reasoning: Exceptional moat     ║\n║  (gaming ecosystem), but current ║\n║  P/E leaves no margin of safety. ║\n╚══════════════════════════════════╝\n\n╔══════════════════════════════════╗\n║  🧠 Michael Burry                ║\n║  Signal: BEARISH                 ║\n║  Confidence: 72%                 ║\n║  Reasoning: FCF yield ~1.8%,     ║\n║  EV/EBIT ~80x — no deep value    ║\n║  here, this is momentum not math.║\n╚══════════════════════════════════╝\n\n... (11 more sages)\n\n╔══════════════════════════════════════════════╗\n║  🏦 PORTFOLIO MANAGER — FINAL VERDICT        ║\n║  Action: WATCH                               ║\n║  Conviction: MEDIUM                          ║\n║  Entry Strategy: Wait for 20-25% pullback    ║\n╚══════════════════════════════════════════════╝\n```\n\n---\n\n## 🧑‍💼 The Council of 13 Sages\n\n| # | Sage | Philosophy | Style |\n|---|------|-----------|-------|\n| 1 | **Warren Buffett** | Wonderful companies at fair prices | Patient, moat-focused |\n| 2 | **Charlie Munger** | Invert always invert | Multi-disciplinary, blunt |\n| 3 | **Benjamin Graham** | Margin of safety, Mr. Market | Quantitative, academic |\n| 4 | **Peter Lynch** | Ten-baggers, invest in what you know | Enthusiastic, accessible |\n| 5 | **Michael Burry** | Deep value contrarian | Data-obsessed, terse |\n| 6 | **Cathie Wood** | Disruptive innovation | Evangelical, future-focused |\n| 7 | **Stanley Druckenmiller** | Asymmetric macro opportunities | Confident, macro sweep |\n| 8 | **Bill Ackman** | Activist, simple businesses | Direct, catalyst-driven |\n| 9 | **Phil Fisher** | Scuttlebutt, quality forever | Meticulous, qualitative |\n| 10 | **Nassim Taleb** | Antifragility, tail risk | Precise, uncompromising |\n| 11 | **Mohnish Pabrai** | Dhandho, downside first | Humble, Buffett-inspired |\n| 12 | **Aswath Damodaran** | Story + numbers, DCF | Professor-like, rigorous |\n| 13 | **Rakesh Jhunjhunwala** | Be right, sit tight | Conviction, long-term |\n\n---\n\n## 🚀 Quick Start\n\n### Claude Code (Recommended)\n\n**Via Plugin Marketplace (recommended):**\n```bash\n/plugin marketplace add hyhmrright/market-sages\n/plugin install market-sages@market-sages-marketplace\n```\n\n**One-liner install (no clone needed):**\n```bash\ncurl -sL https://raw.githubusercontent.com/hyhmrright/market-sages/main/skill.md \\\n  -o ~/.claude/skills/market-sages.md\n```\n\n**Manual install:**\n```bash\ngit clone https://github.com/hyhmrright/market-sages.git\ncp market-sages/skill.md ~/.claude/skills/market-sages.md\n```\n\n**Verify:** Open a Claude Code session and type `/sages AAPL` — you should see the council spin up.\n\n**Use:**\n```\n/sages AAPL\n/sages TSLA --value\n/sages AMZN --growth\n/sages MSFT --risk\n/sages compare AAPL MSFT GOOG\n```\n\n→ [Full Claude Code guide](docs/usage/claude-code.md)\n\n---\n\n### OpenAI Codex CLI\n\n**Via Skill Installer (in a Codex session):**\n```\nInstall the market-sages skill from hyhmrright/market-sages\n```\n\n**Command line:**\n```bash\npython3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \\\n  --repo hyhmrright/market-sages --path skills --name market-sages\n```\n\n**Manual (project-level AGENTS.md):**\n\nFirst time:\n```bash\ncurl -sL https://raw.githubusercontent.com/hyhmrright/market-sages/main/AGENTS.md \\\n  -o ./AGENTS.md\n```\nAlready have an AGENTS.md? Append instead:\n```bash\ncurl -sL https://raw.githubusercontent.com/hyhmrright/market-sages/main/AGENTS.md \\\n  >> ./AGENTS.md\n```\n\n**Use:**\n```bash\ncodex \"Analyze Apple using the Market Sages council\"\ncodex \"Use Michael Burry and Benjamin Graham to evaluate INTC\"\n```\n\n→ [Full Codex CLI guide](docs/usage/codex-cli.md)\n\n---\n\n### Google Gemini CLI\n\n**Via Extension (in a Gemini session):**\n```\n/extensions install https://github.com/hyhmrright/market-sages\n```\n\n**Manual (project-level GEMINI.md):**\n\nFirst time:\n```bash\ncurl -sL https://raw.githubusercontent.com/hyhmrright/market-sages/main/GEMINI.md \\\n  -o ./GEMINI.md\n```\nAlready have a GEMINI.md? Append instead:\n```bash\ncurl -sL https://raw.githubusercontent.com/hyhmrright/market-sages/main/GEMINI.md \\\n  >> ./GEMINI.md\n```\n\n**Use:**\n```bash\ngemini \"Analyze Tesla using all 13 Market Sages\"\ngemini \"Give me Nassim Taleb and Aswath Damodaran's take on NVDA\"\n```\n\n→ [Full Gemini CLI guide](docs/usage/gemini-cli.md)\n\n---\n\n### Universal (Any LLM / Chat Interface)\n\nCopy the contents of `skill.md` as your **system prompt** in any LLM interface — ChatGPT, Claude.ai, Gemini, Perplexity, or any custom app. Then start chatting.\n\n---\n\n## 🎯 Command Reference\n\n| Command | Description |\n|---------|-------------|\n| `/sages AAPL` | Full council (all 13 sages) |\n| `/sages TSLA --value` | Value sages only (Buffett, Munger, Graham, Pabrai, Burry) |\n| `/sages NVDA --growth` | Growth sages only (Lynch, Wood, Druckenmiller, Fisher) |\n| `/sages AMZN --risk` | Risk sages only (Taleb, Damodaran + Risk Manager) |\n| `/sages compare AAPL MSFT` | Side-by-side comparison |\n| `/sages GOOG @buffett @munger` | Specific sages by name |\n\n---\n\n## 💡 Power Tips\n\n**1. Paste your own data for sharper analysis**\n```\n/sages AAPL\n\nRevenue: $391B (+2% YoY)\nNet Income: $94B\nFCF: $107B\nP/E: 28x, EV/EBITDA: 22x\nDebt: $104B, Cash: $65B\nRecent news: Vision Pro sales disappointing...\n```\nThe sages will use your data instead of potentially stale training knowledge.\n\n**2. Ask follow-up questions**\n```\nWhat would make Buffett upgrade to bullish on AAPL?\nWhat's Taleb's worst-case scenario for NVDA?\nHow does Burry's AAPL thesis compare to his typical deep-value plays?\n```\n\n**3. Sector sweeps**\n```\n/sages compare AAPL MSFT GOOG META AMZN  (Big Tech council)\n/sages compare JPM BAC GS                (Banking council)\n```\n\n**4. Portfolio review**\n```\nReview my portfolio: 40% AAPL, 30% NVDA, 20% TSLA, 10% BTC\nWhich sages would be most concerned?\n```\n\n---\n\n## ❓ FAQ & Troubleshooting\n\n**Q: `/sages` command not found after installation**\n```bash\n# Re-copy and verify the file is in the right place\ncp skill.md ~/.claude/skills/market-sages.md\nls ~/.claude/skills/market-sages.md\n```\nThen restart Claude Code and try again.\n\n**Q: The sages are using outdated data**\nPaste current financial data directly in your message — the sages will prioritize it over training knowledge:\n```\n/sages NVDA\nRevenue $60.9B, P/E 55x, Gross Margin 74.6%...\n```\n\n**Q: Can I use only a subset of sages?**\nYes — use `@` to name them:\n```\n/sages AAPL @buffett @graham @burry\n```\n\n**Q: The analysis is in the wrong language**\nThe skill auto-detects your input language. Write your prompt in the language you want the response in.\n\n**Q: How do I run the tests?**\n```bash\n# Structure validation (no API key needed)\nuv run tests/validate_structure.py --verbose\n\n# Prompt evaluation (requires ANTHROPIC_API_KEY)\nexport ANTHROPIC_API_KEY=sk-...\nuv run tests/run_evals.py\n```\n\n---\n\n## 🗂️ Project Structure\n\n```\nmarket-sages/\n├── skill.md              # Core skill — the 13 sages' frameworks\n├── AGENTS.md             # Codex CLI integration\n├── GEMINI.md             # Gemini CLI integration\n├── README.md             # This file\n├── docs/\n│   ├── usage/\n│   │   ├── claude-code.md\n│   │   ├── codex-cli.md\n│   │   └── gemini-cli.md\n│   └── i18n/\n│       ├── README.zh-CN.md\n│       ├── README.ja.md\n│       └── README.ko.md\n└── examples/\n    ├── nvidia-analysis.md\n    └── apple-analysis.md\n```\n\n---\n\n## 🤝 Contributing\n\nWe welcome new sages, prompt improvements, and CLI integrations!\n\n- **Add a new sage**: Open an issue with `new-analyst` label. Include: philosopher/investor, their core framework, signal rules, and voice style.\n- **Improve a prompt**: Open a PR with `prompt-improvement` label. Show before/after examples.\n- **Add CLI support**: Open an issue with `cli-support` label.\n- **Translate docs**: Open a PR with `i18n` label.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.\n\n---\n\n## ⚠️ Disclaimer\n\nMarket Sages is for **educational and entertainment purposes only**.\n\n- Not financial advice\n- AI-generated analysis may be inaccurate or based on stale training data\n- Always verify with current, authoritative financial data\n- Past performance of these investors does not guarantee similar AI output quality\n- Consult a qualified financial advisor before making investment decisions\n\n---\n\n## 📄 License\n\nMIT — use it, fork it, build on it. Attribution appreciated.\n\n---\n\n## ⭐ Star History\n\nIf Market Sages helped you think more clearly about an investment, please star the repo. It helps others find it.\n\n---\n\n*Inspired by [ai-hedge-fund](https://github.com/virattt/ai-hedge-fund) by @virattt — the original multi-agent hedge fund that sparked this idea.*\n",
  "bytes": 9732,
  "sha": "4dfbb7bf48543d404448286b9b8a1aba49b8b8b78727fde0d6e53d6c3d9f3086",
  "repo_slug": "hyhmrright/market-sages",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_hyhmrright_market_sages_80651ea5/readme"
}