Communitygithub.com

modbender/skill-library-mcp

Track stock and crypto portfolios with CLI - real-time prices, P&L, dividend tracking, multiple portfolios

What is skill-library-mcp?

skill-library-mcp is a Claude Code agent skill that track stock and crypto portfolios with CLI - real-time prices, P&L, dividend tracking, multiple portfolios.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/modbender/skill-library-mcp/tree/HEAD/data/claw-portfolio

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Portfolio Tracker

A CLI tool for tracking stock and crypto portfolios with real-time prices, P&L, and dividend tracking.

When to Use This Skill

Use this skill when you need to:

  • Track stock and crypto holdings locally
  • Get real-time prices and P&L
  • Track dividend yields, Yield on Cost, and projected income
  • View upcoming ex-dividend dates
  • Manage multiple portfolios
  • Export portfolio data to CSV

Tools

This skill provides the following capabilities:

1. List Holdings

Show all holdings with current values and P&L.

Command:

npx tsx portfolio.ts list

2. Add Holding

Add a new stock or crypto holding.

Command:

npx tsx portfolio.ts add <symbol> <quantity> <price> <name> [type]

Examples:

npx tsx portfolio.ts add AAPL 10 150 "Apple Inc." stock
npx tsx portfolio.ts add BTC 0.5 45000 Bitcoin crypto

3. Sell Holding

Sell shares using FIFO (First-In-First-Out) cost basis method.

Command:

npx tsx portfolio.ts sell <symbol> <quantity> <price> [date]

Examples:

npx tsx portfolio.ts sell AAPL 5 180 2025-06-01
npx tsx portfolio.ts sell BTC 0.25 50000

4. Transaction History

View sell history for all holdings or a specific symbol.

Command:

npx tsx portfolio.ts history [symbol]

Examples:

npx tsx portfolio.ts history
npx tsx portfolio.ts history AAPL

5. P&L Summary

Show both realized and unrealized profit/loss.

Command:

npx tsx portfolio.ts pnl

6. Dividend Tracking

View detailed dividend information for stock holdings including yield, Yield on Cost (YOC), and projected annual income.

Command:

npx tsx portfolio.ts dividends

7. Dividend Summary

Show portfolio-level dividend summary: total projected income, weighted average yield, and Yield on Cost.

Command:

npx tsx portfolio.ts dividend-summary

Output includes:

  • Total projected annual income
  • Monthly/quarterly income estimates
  • Weighted average yield across all holdings
  • Portfolio Yield on Cost
  • Count of dividend-paying stocks

8. Dividend Calendar

View upcoming ex-dividend dates for your holdings.

Command:

npx tsx portfolio.ts calendar [days]

Examples:

npx tsx portfolio.ts calendar       # Next 30 days
npx tsx portfolio.ts calendar 60    # Next 60 days

9. List with Dividends

The list command automatically fetches dividend data. Use --no-dividends flag to skip.

Commands:

npx tsx portfolio.ts list           # With dividend info
npx tsx portfolio.ts list --no-dividends  # Skip dividends

10. Remove Holding

Remove a holding by symbol.

Command:

npx tsx portfolio.ts remove <symbol>

11. Portfolio Value

Show total portfolio value and P&L.

Command:

npx tsx portfolio.ts value

12. Manage Portfolios

List, switch, or create portfolios.

Commands:

npx tsx portfolio.ts portfolios
npx tsx portfolio.ts switch "Portfolio Name"
npx tsx portfolio.ts create "New Portfolio"

Tip: After running npm link, you can use the shorter portfolio command instead of npx tsx portfolio.ts.

Installation

First, install the required dependencies:

npm install

This will install all necessary packages including TypeScript runtime (tsx), Next.js, React, and other dependencies listed in package.json.

Optional: Link the CLI globally for easier access:

npm link

After linking, you can use portfolio <command> instead of npx tsx portfolio.ts <command>.

NPM Scripts

npm run dev        # Start web UI (optional)
npm run build      # Build for production

Web UI (Optional)

You can also run an optional web interface with full dividend tracking support:

npm run dev

Then open http://localhost:3000

Web UI Features:

  • Real-time portfolio value and P&L tracking
  • Dividend summary cards (annual income, weighted yield, YOC, upcoming dates)
  • Detailed dividend breakdown table per stock
  • Visual calendar of upcoming ex-dividend dates
  • Interactive pie chart for portfolio allocation

Data Storage

Portfolio data is stored locally in data/portfolio.json. The data file is created automatically on first run with an empty portfolio.

Features

  • Real-time stock prices via Yahoo Finance API
  • Real-time crypto prices via CoinGecko API
  • Multiple portfolio support
  • P&L tracking per holding
  • Dividend tracking (yield, YOC, projected income, ex-dates)
  • CLI and optional web interface

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

modbender/skill-library-mcp

Paid acquisition strategy, budget allocation, and avoiding common advertising mistakes across platforms

modbender/skill-library-mcp

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all wit...

modbender/skill-library-mcp

Borrow from Aave via credit delegation. Agent self-funds by borrowing against delegator collateral. Supports borrow, repay, health checks. Works on Aave V2/V3.

modbender/skill-library-mcp

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

modbender/skill-library-mcp

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, explainer videos, virtual influencers, dubbing, marketing videos. Triggers: ai avatar, talking head, lipsync, avatar video, virtual presenter, ai spokesperson, audio driven video, heygen alternative, synthesia alternative, talking avatar, lip sync, video avatar, ai presenter, digital human

modbender/skill-library-mcp

AI代码编辑器规则模板集合 - 为Cursor、Windsurf、Claude Code、Cline等AI编辑器提供项目规则配置。适用于需要配置AI编码助手规则的开发者,包含全栈Web、移动端、Vue3+SpringBoot等技术栈模板。

modbender/skill-library-mcp

Generate landing page code from product descriptions

modbender/skill-library-mcp

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awareness. Triggers: marketing video, ad video, promo video, commercial, brand video, product video, explainer video, ad creative, video ad, facebook ad video, youtube ad, instagram ad, tiktok ad, promotional video, launch video

modbender/skill-library-mcp

Generate AI music videos end-to-end. Creates music with Suno (sunoapi.org), generates visuals with OpenAI/Seedream/Google/Seedance, and assembles into music video with ffmpeg. Supports timestamped lyrics (auto SRT), Suno native music video generation, slideshow/video/hybrid modes. Token-based cost tracking per generation.

modbender/skill-library-mcp

Generate AI-powered notes from videos (document, outline, or graphic-text formats)

modbender/skill-library-mcp

The video AI notes tool is provided by Baidu. Based on the video download address provided by the user, it downloads and parses the video, and finally generates AI notes corresponding to the video (a total of three types of notes can be generated: document notes, outline notes, and image-text notes).

modbender/skill-library-mcp

Automated appointment management for beauty salons, clinics, studios, and photo booths. Handles booking requests, calendar sync, conflict detection, reminders, no-show tracking, and waitlist management.

modbender/skill-library-mcp

Bird identification, life list tracking, and trading card generation. Use this skill when the user: sends a bird photo to identify, says "set up my Birdfolio" or "set my region", asks "how's my checklist", asks "Birdfolio progress", asks "how many birds have I found", asks "show my Birdfolio" or "show my life list", asks "what's my rarest bird", or asks "tell me about [bird species]". Handles everything from first-time setup through ongoing life list tracking and visual trading card generation.

modbender/skill-library-mcp

Multi-project task and research management (JSON-first CLI)

modbender/skill-library-mcp

Track cryptocurrency portfolios with real-time prices, P&L calculations, and allocation analysis. Query Bitcoin, Ethereum, Solana and 10,000+ token holdings.

modbender/skill-library-mcp

加密貨幣Portfolio追蹤 - 支援TRON/ETH/BSC,分析持倉、收益、Gas費用

modbender/skill-library-mcp

Lead strategy with competitive analysis, strategic planning, growth roadmaps, and business portfolio management.

modbender/skill-library-mcp

Create ATS-optimized resumes and CVs with proper structure, metrics, and industry targeting.

modbender/skill-library-mcp

Use this skill when the user asks to build, create, design, develop, or improve ANY frontend interface, web page, UI component, or visual element. This includes: - Building landing pages, websites, web apps, dashboards, portfolios, or any web interface - Creating UI components (buttons, forms, cards, navbars, modals, etc.) - Designing pages with React, Vue, Next.js, Svelte, or any frontend framework - Adding styling or improving visual design of existing components - Implementing specific design aesthetics (modern, dark, minimalist, brutalist, etc.) - User mentions "frontend", "UI", "UX", "design", "interface", "web design", or "styling" - User asks for "beautiful", "modern", "professional", "clean", or any aesthetic adjective - User requests help with CSS, Tailwind, styled-components, or any styling approach This skill automatically retrieves the appropriate design system prompt (Neo-brutalism, Modern Dark, Bauhaus, Cyberpunk, Material, etc.) to help create visually distinctive, production-grade frontend...

modbender/skill-library-mcp

Native video analysis using Google Gemini API. Upload and analyze video files — describe scenes, extract text/UI, answer questions about content, transcribe speech, identify objects and actions. Use when: (1) User sends a video file and wants it analyzed, (2) Video summarization or description needed, (3) Extracting text, UI elements, or information from screen recordings, (4) Answering questions about video content, (5) Comparing multiple videos, (6) Analyzing tutorials, demos, or walkthroughs.

Related Skills