# PROJECT KNOWLEDGE BASE

**Generated:** 2026-03-08  
**Updated:** 2026-03-27 (AlphaEar Finance + Cleanup)  
**Type:** OpenCode Skills Collection - Website Generator + SEO + Finance AI

---

## OVERVIEW

Personal collection of OpenCode skills for AI-powered terminal coding assistant. **60 SKILLS TOTAL.**

### **Core Features:**
- ✅ **Auto-deploy system** - Gitea + Easypanel integration (Dockerfile)
- ✅ **Unified credentials** - Single .env for all skills
- ✅ **PDPA compliance** - Thai law-compliant websites with legal templates
- ✅ **MiniMax API** - TTS, Music, Video, Image generation
- ✅ **Deployment automation** - Easypanel with Docker containers
- ✅ **Working cookie consent** - Actually blocks/enables cookies based on user choice

### **SEO Multi-Channel Marketing:**
- ✅ **Multi-channel content** - Facebook, Facebook Ads, Google Ads, Blog, X/Twitter
- ✅ **Thai language support** - Full PyThaiNLP integration
- ✅ **Analytics integration** - Umami, GA4, GSC, DataForSEO
- ✅ **Image integration** - Auto-generate/edit images for content

### **Finance AI (AlphaEar):**
- ✅ **alphaear-news** - Real-time finance news (10+ sources)
- ✅ **alphaear-stock** - A-Share/HK/US stock data
- ✅ **alphaear-sentiment** - FinBERT/LLM sentiment analysis
- ✅ **alphaear-predictor** - Kronos time-series forecasting
- ✅ **alphaear-signal-tracker** - Signal evolution tracking
- ✅ **alphaear-logic-visualizer** - Draw.io XML finance diagrams
- ✅ **alphaear-reporter** - Professional financial reports
- ✅ **alphaear-search** - Web search + local RAG
- ✅ **alphaear-deepear-lite** - DeepEar Lite API integration

---

## STRUCTURE

```
opencode-skill/
├── .env.example              # Unified credentials template (ALL skills)
├── .env                      # ⚠️ Gitignored - contains actual credentials
├── README.md                 # Quick start guide
├── AGENTS.md                 # This file
├── scripts/
│   └── install-skills.sh     # Installs skills to ~/.config/opencode/
└── skills/                   # 60 skills total
    # Website & Deployment
    ├── gitea-sync/           # Auto-create Gitea repos & push code
    ├── easypanel-deploy/      # Full Python implementation
    └── thai-frontend-dev/     # Astro builder with PDPA templates
    
    # SEO Multi-Channel
    ├── seo-master/            # Master SEO skill (merged)
    ├── seo-multi-channel/     # Generate content for Facebook, Ads, Blog, X
    ├── seo-analyzers/         # Thai keyword, readability, quality
    ├── seo-data/              # Analytics: Umami, GA4, GSC, DataForSEO
    ├── seo-context/           # Per-project context file management
    ├── seo-geo/               # AI search optimization
    └── umami/                # Umami Analytics integration
    
    # Finance AI (AlphaEar)
    ├── alphaear-news/         # Real-time finance news
    ├── alphaear-stock/        # A-Share/HK/US stock data
    ├── alphaear-sentiment/    # FinBERT/LLM sentiment
    ├── alphaear-predictor/    # Kronos forecasting
    ├── alphaear-signal-tracker/
    ├── alphaear-logic-visualizer/
    ├── alphaear-reporter/
    ├── alphaear-search/
    └── alphaear-deepear-lite/
    
    # Development Skills
    ├── frontend-dev/          # Full-stack frontend
    ├── fullstack-dev/          # Backend + frontend
    ├── android-native-dev/     # Android development
    ├── ios-application-dev/    # iOS development
    ├── skill-creator/          # Scaffold new skills
    ├── testing-master/         # TDD, E2E, Playwright
    ├── testing-patterns/        # JS/Python testing patterns
    ├── security-auditor/       # Vulnerability scanning
    ├── security-coder/         # Secure coding
    ├── pentesting/            # SQL injection, SSRF, etc.
    ├── architecture/           # C4, ADRs, system design
    ├── backend-architect/     # API design, microservices
    ├── database-architect/    # Schema modeling
    └── ... (30+ more skills)
```

---

## CREDENTIALS

### Required
| Variable | Description |
|----------|-------------|
| `MINIMAX_API_KEY` | TTS, Music, Video, Image generation |

### Optional
| Variable | Description |
|----------|-------------|
| `GITEA_*` | Git sync features |
| `EASYPANEL_*` | Auto-deployment |
| `UMAMI_*` | Analytics |
| `GA4_*`, `GSC_*` | Google analytics |
| `DATAFORSEO_*` | Competitor analysis |
| `JINA_API_KEY` | Content extraction (free tier: 20 req/min without key) |
| `LLM_*` | AlphaEar LLM config (MiniMax default) |

---

## COMMANDS

```bash
# Install all skills
./scripts/install-skills.sh

# Create new skill
python3 skills/skill-creator/scripts/create_skill.py my-skill "Description"

# Generate website (auto-deploys)
python3 skills/thai-frontend-dev/scripts/create_astro_website.py --name "my-site"

# Deploy to Easypanel
python3 skills/easypanel-deploy/scripts/deploy.py --project x --service y --git-url z
```

---

## ANTI-PATTERNS

- **NEVER** commit `.env` files
- **NEVER** return images as base64 (save to file)
- **NEVER** hardcode credentials (use .env)
- **NEVER** skip error handling in deploy workflows

---

## NOTES

- All 60 skills have scripts (no docs-only skills)
- AlphaEar skills use MiniMax by default (OpenAI compatible)
- Embedding models run offline (no API calls)
- Jina content extraction works without API key (rate limited)
