@thanhvn14/csvibe 0.1.3 → 0.1.5

package/.github/skills/.env.example

@@ -0,0 +1,100 @@
+# Claude Code - Skills Shared Environment Variables
+# Location: .claude/skills/.env
+# Priority: Medium (overrides .claude/.env, overridden by skill-specific .env)
+# Scope: Shared across all skills, higher priority than global .claude/.env
+# Setup: Copy to .claude/skills/.env and configure
+
+# ============================================
+# Environment Variable Hierarchy
+# ============================================
+# Priority order (highest to lowest):
+# 1. process.env                    - Runtime environment (HIGHEST)
+# 2. .claude/skills/<skill>/.env    - Skill-specific overrides
+# 3. .claude/skills/.env            - Shared across skills (this file)
+# 4. .claude/.env                   - Global defaults (LOWEST)
+#
+# All skills use centralized resolver: ~/.claude/scripts/resolve_env.py
+# Debug hierarchy: python ~/.claude/scripts/resolve_env.py --show-hierarchy --skill <skill-name>
+
+# ============================================
+# Common Skill API Keys
+# ============================================
+# Google Gemini API (shared by multiple skills)
+# Skills using: ai-multimodal, docs-seeker, repomix
+# Get from: https://aistudio.google.com/apikey
+GEMINI_API_KEY=
+
+# Vertex AI (Optional, for production workloads)
+# GEMINI_USE_VERTEX=true
+# VERTEX_PROJECT_ID=
+# VERTEX_LOCATION=us-central1
+
+# ============================================
+# Payment Integration APIs
+# ============================================
+# SePay API (Vietnamese payment gateway)
+# Skill: payment-integration
+# SEPAY_API_KEY=
+# SEPAY_WEBHOOK_SECRET=
+
+# Polar API (Global SaaS monetization)
+# Skill: payment-integration
+# POLAR_ACCESS_TOKEN=
+# POLAR_WEBHOOK_SECRET=
+
+# ============================================
+# MCP Server Configuration
+# ============================================
+# Context7 MCP (Documentation search)
+# Skill: docs-seeker, mcp-management
+# CONTEXT7_API_KEY=
+
+# ============================================
+# Development Tools
+# ============================================
+# Chrome DevTools (for chrome-devtools skill)
+# CHROME_EXECUTABLE_PATH=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
+# PUPPETEER_SKIP_DOWNLOAD=true
+
+# ============================================
+# Media Processing
+# ============================================
+# FFmpeg path (if not in PATH)
+# Skill: media-processing, ai-multimodal
+# FFMPEG_PATH=/usr/local/bin/ffmpeg
+
+# ImageMagick path (if not in PATH)
+# Skill: media-processing
+# IMAGEMAGICK_PATH=/usr/local/bin/convert
+
+# ============================================
+# Database Configuration (Shared)
+# ============================================
+# Common database URLs shared across skills
+# DATABASE_URL=postgresql://user:pass@localhost:5432/db
+# MONGODB_URI=mongodb://localhost:27017/db
+# REDIS_URL=redis://localhost:6379
+
+# ============================================
+# Example Usage Scenarios
+# ============================================
+# Scenario 1: Global default for all skills
+# .claude/.env:                            GEMINI_API_KEY=global-dev-key
+# Result: All skills use global-dev-key
+#
+# Scenario 2: Override for all skills
+# .claude/.env:                            GEMINI_API_KEY=global-dev-key
+# .claude/skills/.env (this file):         GEMINI_API_KEY=skills-prod-key
+# Result: All skills use skills-prod-key
+#
+# Scenario 3: Skill-specific override
+# .claude/.env:                            GEMINI_API_KEY=global-key
+# .claude/skills/.env (this file):         GEMINI_API_KEY=shared-key
+# .claude/skills/ai-multimodal/.env:       GEMINI_API_KEY=high-quota-key
+# Result: ai-multimodal uses high-quota-key, other skills use shared-key
+#
+# Scenario 4: Runtime testing
+# export GEMINI_API_KEY=test-key
+# Result: All skills use test-key regardless of config files
+#
+# Priority: runtime > skill-specific > shared (this file) > global

package/.github/skills/.install-state.json

@@ -0,0 +1,23 @@
+{
+    "packages":  {
+                     "failed":  [
+
+                                ],
+                     "skipped":  [
+
+                                 ],
+                     "installed":  [
+
+                                   ]
+                 },
+    "phases":  {
+                   "system_deps":  "done",
+                   "node_deps":  "done",
+                   "python_env":  "done",
+                   "verify":  "done",
+                   "chocolatey":  "done"
+               },
+    "version":  1,
+    "last_updated":  "2025-12-25T22:22:50Z",
+    "started_at":  "2025-12-25T22:19:53Z"
+}

package/.github/skills/README.md

@@ -0,0 +1,149 @@
+# Skills
+Skills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. Skills teach Claude how to complete specific tasks in a repeatable way, whether that's creating documents with your company's brand guidelines, analyzing data using your organization's specific workflows, or automating personal tasks.
+
+For more information, check out:
+- [What are skills?](https://support.claude.com/en/articles/12512176-what-are-skills)
+- [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude)
+- [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills)
+- [Equipping agents for the real world with Agent Skills](https://anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
+
+# About This Repository
+
+This repository contains example skills that demonstrate what's possible with Claude's skills system. These examples range from creative applications (art, music, design) to technical tasks (testing web apps, MCP server generation) to enterprise workflows (communications, branding, etc.).
+
+Each skill is self-contained in its own directory with a `SKILL.md` file containing the instructions and metadata that Claude uses. Browse through these examples to get inspiration for your own skills or to understand different patterns and approaches.
+
+The example skills in this repo are open source (Apache 2.0). We've also included the document creation & editing skills that power [Claude's document capabilities](https://www.anthropic.com/news/create-files) under the hood in the [`document-skills/`](./document-skills/) folder. These are source-available, not open source, but we wanted to share these with developers as a reference for more complex skills that are actively used in a production AI application.
+
+**Note:** These are reference examples for inspiration and learning. They showcase general-purpose capabilities rather than organization-specific workflows or sensitive content.
+
+## Disclaimer
+
+**These skills are provided for demonstration and educational purposes only.** While some of these capabilities may be available in Claude, the implementations and behaviors you receive from Claude may differ from what is shown in these examples. These examples are meant to illustrate patterns and possibilities. Always test skills thoroughly in your own environment before relying on them for critical tasks.
+
+# Installation
+
+Some skills require external dependencies (FFmpeg, ImageMagick, Node.js packages, Python packages). Use our automated installation scripts to set up all dependencies:
+
+## Automated Installation (Recommended)
+
+**Linux/macOS:**
+```bash
+cd %USERPROFILE%/.claude/skills
+./install.sh
+```
+
+**Windows (PowerShell as Administrator):**
+```powershell
+cd .claude\skills
+.\install.ps1
+```
+
+The installation scripts will:
+- Install system tools (FFmpeg, ImageMagick)
+- Install Node.js packages (rmbg-cli, pnpm, wrangler, repomix)
+- Create Python virtual environment
+- Install Python packages (google-genai, pypdf, Pillow, etc.)
+- Install test dependencies
+- Verify all installations
+
+## Manual Installation
+
+For manual installation or troubleshooting, see [INSTALLATION.md](INSTALLATION.md) for detailed instructions.
+
+## What Gets Installed
+
+- **System Tools**: FFmpeg, ImageMagick
+- **Node.js Packages**: rmbg-cli, pnpm, wrangler, repomix
+- **Python Packages**: google-genai, pypdf, python-docx, Pillow, pytest
+
+See [INSTALLATION.md](INSTALLATION.md) for complete dependency list and platform-specific instructions.
+
+# Example Skills
+
+This repository includes a diverse collection of example skills demonstrating different capabilities:
+
+## Creative & Design
+- **algorithmic-art** - Create generative art using p5.js with seeded randomness, flow fields, and particle systems
+- **canvas-design** - Design beautiful visual art in .png and .pdf formats using design philosophies
+- **slack-gif-creator** - Create animated GIFs optimized for Slack's size constraints
+
+## Development & Technical
+- **artifacts-builder** - Build complex claude.ai HTML artifacts using React, Tailwind CSS, and shadcn/ui components
+- **mcp-server** - Guide for creating high-quality MCP servers to integrate external APIs and services
+- **webapp-testing** - Test local web applications using Playwright for UI verification and debugging
+
+## Enterprise & Communication
+- **brand-guidelines** - Apply Anthropic's official brand colors and typography to artifacts
+- **internal-comms** - Write internal communications like status reports, newsletters, and FAQs
+- **theme-factory** - Style artifacts with 10 pre-set professional themes or generate custom themes on-the-fly
+
+## Meta Skills
+- **skill-creator** - Guide for creating effective skills that extend Claude's capabilities
+- **template-skill** - A basic template to use as a starting point for new skills
+
+# Document Skills
+
+The `document-skills/` subdirectory contains skills that Anthropic developed to help Claude create various document file formats. These skills demonstrate advanced patterns for working with complex file formats and binary data:
+
+- **docx** - Create, edit, and analyze Word documents with support for tracked changes, comments, formatting preservation, and text extraction
+- **pdf** - Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms
+- **pptx** - Create, edit, and analyze PowerPoint presentations with support for layouts, templates, charts, and automated slide generation
+- **xlsx** - Create, edit, and analyze Excel spreadsheets with support for formulas, formatting, data analysis, and visualization
+
+**Important Disclaimer:** These document skills are point-in-time snapshots and are not actively maintained or updated. Versions of these skills ship pre-included with Claude. They are primarily intended as reference examples to illustrate how Anthropic approaches developing more complex skills that work with binary file formats and document structures.
+
+# Try in Claude Code, Claude.ai, and the API
+
+## Claude Code
+You can register this repository as a Claude Code Plugin marketplace by running the following command in Claude Code:
+```
+/plugin marketplace add anthropics/skills
+```
+
+After installing the plugin, you can use the skill by just mentioning it. For instance, if you install the document-skills plugin from the marketplace, you can ask Claude Code to do something like: "use the pdf skill to extract the form fields from path/to/some-file.pdf"
+
+## Claude.ai
+
+These example skills are all already available to paid plans in Claude.ai. 
+
+To use any skill from this repository or upload custom skills, follow the instructions in [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude#h_a4222fa77b).
+
+## Claude API
+
+You can use Anthropic's pre-built skills, and upload custom skills, via the Claude API. See the [Skills API Quickstart](https://docs.claude.com/en/api/skills-guide#creating-a-skill) for more.
+
+# Creating a Basic Skill
+
+Skills are simple to create - just a folder with a `SKILL.md` file containing YAML frontmatter and instructions. You can use the **template-skill** in this repository as a starting point:
+
+```markdown
+---
+name: my-skill-name
+description: A clear description of what this skill does and when to use it
+---
+
+# My Skill Name
+
+[Add your instructions here that Claude will follow when this skill is active]
+
+## Examples
+- Example usage 1
+- Example usage 2
+
+## Guidelines
+- Guideline 1
+- Guideline 2
+```
+
+The frontmatter requires only two fields:
+- `name` - A unique identifier for your skill (lowercase, hyphens for spaces)
+- `description` - A complete description of what the skill does and when to use it
+
+The markdown content below contains the instructions, examples, and guidelines that Claude will follow. For more details, see [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills).
+
+# Partner Skills
+
+Skills are a great way to teach Claude how to get better at using specific pieces of software. As we see awesome example skills from partners, we may highlight some of them here:
+
+- **Notion** - [Notion Skills for Claude](https://www.notion.so/notiondevs/Notion-Skills-for-Claude-28da4445d27180c7af1df7d8615723d0)

package/.github/skills/ai-multimodal/.env.example

@@ -0,0 +1,204 @@
+# Google Gemini API Configuration
+
+# ============================================================================
+# OPTION 1: Google AI Studio (Default - Recommended for most users)
+# ============================================================================
+# Get your API key: https://aistudio.google.com/apikey
+GEMINI_API_KEY=your_api_key_here
+
+# ============================================================================
+# API Key Rotation (Optional - For high-volume usage)
+# ============================================================================
+# Add multiple API keys for automatic rotation on rate limit errors.
+# Free tier accounts are heavily rate-limited; rotation helps distribute load.
+#
+# Format: GEMINI_API_KEY_N where N is 2, 3, 4, etc.
+# The primary GEMINI_API_KEY is always used first.
+#
+# GEMINI_API_KEY_2=your_second_api_key
+# GEMINI_API_KEY_3=your_third_api_key
+# GEMINI_API_KEY_4=your_fourth_api_key
+#
+# Features:
+# - Auto-rotates on RESOURCE_EXHAUSTED / 429 errors
+# - 60-second cooldown per key after rate limit
+# - Logs rotation events with --verbose flag
+# - Backward compatible: single key still works
+
+# ============================================================================
+# OPTION 2: Vertex AI (Google Cloud Platform)
+# ============================================================================
+# Uncomment these lines to use Vertex AI instead of Google AI Studio
+# GEMINI_USE_VERTEX=true
+# VERTEX_PROJECT_ID=your-gcp-project-id
+# VERTEX_LOCATION=us-central1
+
+# ============================================================================
+# Model Selection (Optional)
+# ============================================================================
+# Override default models for specific capabilities
+# If not set, intelligent defaults are used based on task type
+
+# --- Image Generation ---
+# Used by: --task generate (image)
+# Default: gemini-2.5-flash-image (Nano Banana Flash - fast, cost-effective)
+# Alternative: imagen-4.0-generate-001 (production quality)
+# NOTE: All image generation requires billing - no free tier available (limit: 0)
+# Options:
+#   gemini-2.5-flash-image            - Nano Banana Flash: fast, ~$1/1M tokens (DEFAULT)
+#   gemini-3-pro-image-preview        - Nano Banana Pro: 4K text, reasoning (requires billing)
+#   imagen-4.0-generate-001           - Imagen 4 Standard: production quality (~$0.02/image)
+#   imagen-4.0-ultra-generate-001     - Imagen 4 Ultra: maximum quality (~$0.04/image)
+#   imagen-4.0-fast-generate-001      - Imagen 4 Fast: speed-optimized (~$0.01/image)
+# IMAGE_GEN_MODEL=gemini-2.5-flash-image
+
+# --- Video Generation ---
+# Used by: --task generate-video (new capability)
+# Default: veo-3.1-generate-preview
+# NOTE: Video generation requires billing - no free tier fallback available
+# Options:
+#   veo-3.1-generate-preview       - Latest, native audio, frame control (requires billing)
+#   veo-3.1-fast-generate-preview  - Speed-optimized for business (requires billing)
+#   veo-3.0-generate-001           - Stable, native audio, 8s videos (requires billing)
+#   veo-3.0-fast-generate-001      - Stable fast variant (requires billing)
+# VIDEO_GEN_MODEL=veo-3.1-generate-preview
+
+# --- Multimodal Analysis ---
+# Used by: --task analyze, transcribe, extract
+# Default: gemini-2.5-flash
+# Options:
+#   gemini-3-pro-preview           - Latest, agentic workflows, 1M context
+#   gemini-2.5-flash               - Best price/performance (recommended)
+#   gemini-2.5-pro                 - Highest quality
+# MULTIMODAL_MODEL=gemini-2.5-flash
+
+# --- Legacy Compatibility ---
+# Generic model override (use specific variables above instead)
+# GEMINI_MODEL=gemini-2.5-flash
+# GEMINI_IMAGE_GEN_MODEL=gemini-2.5-flash-image
+
+# ============================================================================
+# Rate Limiting Configuration (Optional)
+# ============================================================================
+# Requests per minute limit (adjust based on your tier)
+# GEMINI_RPM_LIMIT=15
+
+# Tokens per minute limit
+# GEMINI_TPM_LIMIT=4000000
+
+# Requests per day limit
+# GEMINI_RPD_LIMIT=1500
+
+# ============================================================================
+# Video Generation Options (Optional)
+# ============================================================================
+# Video duration in seconds (8s only for now)
+# VEO_DURATION=8
+
+# Video resolution: 720p or 1080p
+# VEO_RESOLUTION=1080p
+
+# Aspect ratio: 16:9, 9:16, 1:1 (16:9 is default)
+# VEO_ASPECT_RATIO=16:9
+
+# Frame rate: 24fps (fixed for now)
+# VEO_FPS=24
+
+# Enable native audio generation
+# VEO_AUDIO=true
+
+# ============================================================================
+# Image Generation Options (Optional)
+# ============================================================================
+# Number of images to generate (1-4)
+# IMAGEN_NUM_IMAGES=1
+
+# Image size: 1K or 2K (Ultra/Standard only)
+# IMAGEN_SIZE=1K
+
+# Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4
+# IMAGEN_ASPECT_RATIO=1:1
+
+# Enable person generation (restricted in EEA, CH, UK)
+# IMAGEN_PERSON_GENERATION=true
+
+# Add SynthID watermark (always enabled by default)
+# IMAGEN_WATERMARK=true
+
+# ============================================================================
+# Processing Options (Optional)
+# ============================================================================
+# Video resolution mode: default or low-res
+# low-res uses ~100 tokens/second vs ~300 for default
+# GEMINI_VIDEO_RESOLUTION=default
+
+# Audio quality: default (16 Kbps mono, auto-downsampled)
+# GEMINI_AUDIO_QUALITY=default
+
+# PDF processing mode: inline (<20MB) or file-api (>20MB, automatic)
+# GEMINI_PDF_MODE=auto
+
+# ============================================================================
+# Retry Configuration (Optional)
+# ============================================================================
+# Maximum retry attempts for failed requests
+# GEMINI_MAX_RETRIES=3
+
+# Initial retry delay in seconds (uses exponential backoff)
+# GEMINI_RETRY_DELAY=1
+
+# ============================================================================
+# Output Configuration (Optional)
+# ============================================================================
+# Default output directory for generated images
+# OUTPUT_DIR=./output
+
+# Image output format (png or jpeg)
+# IMAGE_FORMAT=png
+
+# Image quality for JPEG (1-100)
+# IMAGE_QUALITY=95
+
+# ============================================================================
+# Context Caching (Optional)
+# ============================================================================
+# Enable context caching for repeated queries on same file
+# GEMINI_ENABLE_CACHING=true
+
+# Cache TTL in seconds (default: 1800 = 30 minutes)
+# GEMINI_CACHE_TTL=1800
+
+# ============================================================================
+# Logging (Optional)
+# ============================================================================
+# Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL
+# LOG_LEVEL=INFO
+
+# Log file path
+# LOG_FILE=./logs/gemini.log
+
+# ============================================================================
+# Pricing Reference (as of 2025-11)
+# ============================================================================
+# Gemini 2.5 Flash: $1.00/1M input, $0.10/1M output
+# Gemini 2.5 Pro: $3.00/1M input, $12.00/1M output
+# Gemini 3 Pro: $2.00/1M input (<200k), $4.00 (>200k), $12/$18 output
+# Imagen 4: ~$0.01-$0.04 per image (varies by variant)
+# Veo 3: TBD (preview pricing)
+# Monitor: https://ai.google.dev/pricing
+
+# ============================================================================
+# Notes
+# ============================================================================
+# 1. Never commit API keys to version control
+# 2. Add .env to .gitignore
+# 3. API keys can be restricted in Google Cloud Console
+# 4. Monitor usage at: https://aistudio.google.com/apikey
+# 5. Free tier limits: 15 RPM, 1M-4M TPM, 1,500 RPD
+# 6. Vertex AI requires GCP authentication via gcloud CLI
+# 7. Model defaults (Dec 2025):
+#    - Image gen: gemini-2.5-flash-image (Nano Banana Flash - default)
+#    - Image gen: imagen-4.0-generate-001 (alternative for production)
+#    - Video gen: veo-3.1-generate-preview
+#    - Analysis: gemini-2.5-flash
+# 8. Preview models (veo-3.1, gemini-3) may have API changes