feat: Add GLM Tools, Skills & Agents collection
This commit is contained in:
admin
277
skills/ai-platforms-consolidated/SKILL.md
Normal file
277
skills/ai-platforms-consolidated/SKILL.md
Normal file
@@ -0,0 +1,277 @@
|
||||
---
|
||||
name: ai-platforms-consolidated
|
||||
description: "Consolidated AI platforms reference. AUTO-TRIGGERS when: comparing AI platforms, cross-platform patterns, choosing between tools, MiniMax vs Super Z, multimodal capabilities overview, expert agents summary, document processing matrix, SDK patterns comparison."
|
||||
priority: 90
|
||||
autoTrigger: true
|
||||
triggers:
|
||||
- "compare platforms"
|
||||
- "which platform"
|
||||
- "AI platform"
|
||||
- "MiniMax vs"
|
||||
- "Super Z vs"
|
||||
- "GLM vs"
|
||||
- "cross-platform"
|
||||
- "expert agent"
|
||||
- "multimodal capabilities"
|
||||
- "document processing"
|
||||
- "image operations"
|
||||
- "video operations"
|
||||
- "audio operations"
|
||||
- "SDK comparison"
|
||||
- "tech stack comparison"
|
||||
- "agent design patterns"
|
||||
---
|
||||
|
||||
# AI Platforms Consolidated Reference
|
||||
|
||||
Quick reference guide combining expertise from MiniMax, Super Z (GLM), and z.ai tooling.
|
||||
|
||||
---
|
||||
|
||||
## Quick Navigation
|
||||
|
||||
| Need | Skill to Use | Source |
|
||||
|------|-------------|--------|
|
||||
| Agent design inspiration | `/minimax-experts` | MiniMax Platform |
|
||||
| Multimodal AI patterns | `/glm-skills` | Super Z Platform |
|
||||
| Next.js 15 development | `/zai-tooling-reference` | z.ai Tooling |
|
||||
| Document processing | This file | All platforms |
|
||||
|
||||
---
|
||||
|
||||
## Platform Comparison
|
||||
|
||||
| Feature | MiniMax | Super Z (GLM) |
|
||||
|---------|---------|---------------|
|
||||
| Expert Agents | 40 | 6 subagents |
|
||||
| Focus | Business/Creative | Technical/Development |
|
||||
| SDK | Platform-specific | z-ai-web-dev-sdk |
|
||||
| Image Generation | Built-in | SDK-based |
|
||||
| Video Generation | Built-in | SDK-based |
|
||||
| Document Processing | Doc Processor | PDF/DOCX/XLSX/PPTX |
|
||||
| Audio | Limited | ASR + TTS |
|
||||
|
||||
---
|
||||
|
||||
## Expert Agent Categories
|
||||
|
||||
### Content Creation (Both Platforms)
|
||||
|
||||
| Expert | Platform | Best For |
|
||||
|--------|----------|----------|
|
||||
| Landing Page Builder | MiniMax | Marketing pages |
|
||||
| Visual Lab | MiniMax | Presentations, infographics |
|
||||
| Video Story Generator | MiniMax | Video from images/text |
|
||||
| Icon Maker | MiniMax | App/web icons |
|
||||
| image-generation | Super Z | Programmatic image creation |
|
||||
| podcast-generate | Super Z | Audio content |
|
||||
| story-video-generation | Super Z | Story to video |
|
||||
|
||||
### Finance & Trading (MiniMax)
|
||||
|
||||
| Expert | Specialization |
|
||||
|--------|---------------|
|
||||
| Hedge Fund Expert Team | 18-analyst team (Buffett, Munger perspectives) |
|
||||
| AI Trading Consortium | Multi-strategy trading |
|
||||
| Crypto Trading Agent | BTC/ETH/SOL with risk management |
|
||||
| Quant Trading Strategist | Options, futures, backtesting |
|
||||
|
||||
### Development (Both Platforms)
|
||||
|
||||
| Expert | Platform | Specialization |
|
||||
|--------|----------|---------------|
|
||||
| Mini Coder Max | MiniMax | Parallel subagent coding |
|
||||
| Peak Coder | MiniMax | Checklist-driven development |
|
||||
| Prompt Development Studio | MiniMax | Prompt engineering |
|
||||
| Remotion Video Assistant | MiniMax | React video development |
|
||||
| full-stack-developer | Super Z | Next.js + Prisma |
|
||||
| frontend-styling-expert | Super Z | CSS, responsive design |
|
||||
|
||||
### Career & Business
|
||||
|
||||
| Expert | Platform | Use Case |
|
||||
|--------|----------|----------|
|
||||
| Job Hunter Agent | MiniMax | Auto job application |
|
||||
| CV Optimization Expert | MiniMax | ATS-optimized resumes |
|
||||
| CEO Assistant | MiniMax | Executive support |
|
||||
| PRD Assistant | MiniMax | Product requirements |
|
||||
| SaaS Niche Finder | MiniMax | Business validation |
|
||||
|
||||
---
|
||||
|
||||
## Document Processing Matrix
|
||||
|
||||
| Format | MiniMax (Doc Processor) | Super Z Skill |
|
||||
|--------|------------------------|---------------|
|
||||
| PDF | Create, convert, edit | pdf skill |
|
||||
| DOCX | Full lifecycle | docx skill |
|
||||
| XLSX | Limited | xlsx skill (formulas, charts) |
|
||||
| PPTX | Limited | pptx skill |
|
||||
|
||||
---
|
||||
|
||||
## Multimodal Capabilities
|
||||
|
||||
### Image Operations
|
||||
|
||||
| Task | MiniMax | Super Z SDK |
|
||||
|------|---------|-------------|
|
||||
| Generate | Icon Maker, Image Craft | `zai.images.generations.create()` |
|
||||
| Edit | Image Craft Pro | `zai.images.edits.create()` |
|
||||
| Understand | Limited | `image-understand` skill |
|
||||
| Stickers | GIF Sticker Maker | Custom implementation |
|
||||
|
||||
### Video Operations
|
||||
|
||||
| Task | MiniMax | Super Z SDK |
|
||||
|------|---------|-------------|
|
||||
| Generate | Video Story Generator | `video-generation` skill |
|
||||
| Understand | Limited | `video-understand` skill |
|
||||
| Story to Video | Built-in | `story-video-generation` |
|
||||
|
||||
### Audio Operations
|
||||
|
||||
| Task | MiniMax | Super Z SDK |
|
||||
|------|---------|-------------|
|
||||
| Speech to Text | Limited | `ASR` skill |
|
||||
| Text to Speech | Limited | `TTS` skill |
|
||||
| Podcast | Limited | `podcast-generate` |
|
||||
|
||||
---
|
||||
|
||||
## Design Patterns Reference
|
||||
|
||||
### Multi-Agent Teams
|
||||
```
|
||||
Use when: Complex analysis requiring multiple perspectives
|
||||
Pattern: Hedge Fund Expert (18 specialists)
|
||||
Implementation: Spawn subagents with specific roles
|
||||
```
|
||||
|
||||
### Safety-First Operations
|
||||
```
|
||||
Use when: Destructive operations, file management
|
||||
Pattern: Tidy Folder (backup before, move not delete)
|
||||
Implementation: Automatic backups, reversible actions
|
||||
```
|
||||
|
||||
### One-to-Many Generation
|
||||
```
|
||||
Use when: Creative exploration, A/B testing
|
||||
Pattern: GIF Sticker Maker (4 variations), 9 Cinematic Angles
|
||||
Implementation: Single input → multiple output variations
|
||||
```
|
||||
|
||||
### Perspective Simulation
|
||||
```
|
||||
Use when: Decision validation, bias checking
|
||||
Pattern: AI Trading Consortium (Buffett, Lynch, Burry)
|
||||
Implementation: Generate multiple expert opinions
|
||||
```
|
||||
|
||||
### Binary Decision Systems
|
||||
```
|
||||
Use when: Risk management, clear action signals
|
||||
Pattern: Crypto Trading Agent (EXECUTE/NO TRADE)
|
||||
Implementation: Strict output constraints
|
||||
```
|
||||
|
||||
### Multi-Format Output
|
||||
```
|
||||
Use when: Reaching different audiences
|
||||
Pattern: Knowledge Digest (notes, quizzes, slides, audio)
|
||||
Implementation: Transform single source to multiple formats
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## SDK Quick Reference (z-ai-web-dev-sdk)
|
||||
|
||||
### Initialization
|
||||
```javascript
|
||||
import ZAI from 'z-ai-web-dev-sdk';
|
||||
const zai = await ZAI.create();
|
||||
```
|
||||
|
||||
### LLM Chat
|
||||
```javascript
|
||||
const completion = await zai.chat.completions.create({
|
||||
messages: [
|
||||
{ role: 'system', content: 'You are helpful.' },
|
||||
{ role: 'user', content: 'Hello!' }
|
||||
]
|
||||
});
|
||||
```
|
||||
|
||||
### Image Generation
|
||||
```javascript
|
||||
const image = await zai.images.generations.create({
|
||||
prompt: 'A sunset over mountains',
|
||||
size: '1024x1024'
|
||||
});
|
||||
// image.data[0].base64 contains the image
|
||||
```
|
||||
|
||||
### Web Search
|
||||
```javascript
|
||||
const results = await zai.functions.invoke("web_search", {
|
||||
query: "latest AI news",
|
||||
num: 10
|
||||
});
|
||||
```
|
||||
|
||||
### Video Generation (Async)
|
||||
```javascript
|
||||
const task = await zai.videos.generations.create({ prompt });
|
||||
const status = await zai.videos.generations.status(task.id);
|
||||
const result = await zai.videos.generations.retrieve(task.id);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Tech Stack Reference (z.ai Tooling)
|
||||
|
||||
| Layer | Technology |
|
||||
|-------|------------|
|
||||
| Framework | Next.js 16 + React 19 |
|
||||
| Language | TypeScript 5 |
|
||||
| Styling | Tailwind CSS 4 |
|
||||
| UI | shadcn/ui (50+ components) |
|
||||
| Database | Prisma + SQLite |
|
||||
| State | Zustand |
|
||||
| Data Fetching | TanStack Query |
|
||||
| AI | z-ai-web-dev-sdk |
|
||||
| Auth | NextAuth |
|
||||
| Package Manager | Bun |
|
||||
|
||||
---
|
||||
|
||||
## When to Use This Reference
|
||||
|
||||
1. **Choosing the right tool**: Compare platforms side-by-side
|
||||
2. **Cross-platform patterns**: Learn from multiple implementations
|
||||
3. **SDK integration**: Quick code snippets
|
||||
4. **Design decisions**: Pattern matching for your use case
|
||||
5. **Skill discovery**: Find relevant capabilities
|
||||
|
||||
---
|
||||
|
||||
## Installed Skills Summary
|
||||
|
||||
| Skill | Location | Content |
|
||||
|-------|----------|---------|
|
||||
| minimax-experts | `~/.claude/skills/minimax-experts/` | 40 AI experts catalog |
|
||||
| glm-skills | `~/.claude/skills/glm-skills/` | Super Z skills & SDK |
|
||||
| zai-tooling-reference | `~/.claude/skills/zai-tooling-reference/` | Next.js 15 patterns |
|
||||
| ai-platforms-consolidated | `~/.claude/skills/ai-platforms-consolidated/` | This file |
|
||||
|
||||
## Codebase Reference
|
||||
|
||||
| Location | Content |
|
||||
|----------|---------|
|
||||
| `~/reference-codebases/z-ai-tooling/` | Full Next.js 15 project |
|
||||
|
||||
---
|
||||
|
||||
*Generated from MiniMax Expert Catalog, GLM5 Agents & Skills, and z.ai Tooling documentation*
|
||||
*Installation date: 2026-02-13*
|
||||
527
skills/glm-skills/SKILL.md
Normal file
527
skills/glm-skills/SKILL.md
Normal file
@@ -0,0 +1,527 @@
|
||||
---
|
||||
name: glm-skills
|
||||
description: "Reference for Super Z/GLM platform skills and SDK. AUTO-TRIGGERS when: speech-to-text, ASR, TTS, text-to-speech, image generation, video generation, VLM, vision model, PDF processing, DOCX, XLSX, PPTX, web search, web scraping, podcast generation, multimodal AI, z-ai-web-dev-sdk."
|
||||
priority: 100
|
||||
autoTrigger: true
|
||||
triggers:
|
||||
- "speech to text"
|
||||
- "ASR"
|
||||
- "transcribe"
|
||||
- "text to speech"
|
||||
- "TTS"
|
||||
- "voice"
|
||||
- "image generation"
|
||||
- "generate image"
|
||||
- "video generation"
|
||||
- "generate video"
|
||||
- "VLM"
|
||||
- "vision language"
|
||||
- "analyze image"
|
||||
- "PDF"
|
||||
- "DOCX"
|
||||
- "XLSX"
|
||||
- "PPTX"
|
||||
- "spreadsheet"
|
||||
- "presentation"
|
||||
- "web search"
|
||||
- "web scraping"
|
||||
- "podcast"
|
||||
- "multimodal"
|
||||
- "z-ai-web-dev-sdk"
|
||||
- "Super Z"
|
||||
- "GLM"
|
||||
---
|
||||
|
||||
# Super Z / GLM Skills & Agents Reference
|
||||
|
||||
Complete reference for the Super Z (z.ai) platform's skills system, agents, and development patterns.
|
||||
|
||||
---
|
||||
|
||||
## SDK: z-ai-web-dev-sdk
|
||||
|
||||
All skills use the `z-ai-web-dev-sdk` JavaScript/TypeScript SDK.
|
||||
|
||||
### Installation
|
||||
```bash
|
||||
npm install z-ai-web-dev-sdk
|
||||
# or
|
||||
bun add z-ai-web-dev-sdk
|
||||
```
|
||||
|
||||
### Initialization
|
||||
```javascript
|
||||
import ZAI from 'z-ai-web-dev-sdk';
|
||||
|
||||
const zai = await ZAI.create();
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Multimodal AI Skills
|
||||
|
||||
### ASR (Automatic Speech Recognition)
|
||||
**Command**: `ASR`
|
||||
|
||||
Speech-to-text using z-ai-web-dev-sdk.
|
||||
|
||||
```javascript
|
||||
// Supports base64 encoded audio
|
||||
const transcription = await zai.asr.transcribe({
|
||||
audio: audioBase64
|
||||
});
|
||||
```
|
||||
|
||||
**Use Cases**: Transcription, voice input, audio processing
|
||||
|
||||
---
|
||||
|
||||
### TTS (Text-to-Speech)
|
||||
**Command**: `TTS`
|
||||
|
||||
Convert text to natural-sounding speech.
|
||||
|
||||
```javascript
|
||||
const audio = await zai.tts.synthesize({
|
||||
text: "Hello world",
|
||||
voice: "default",
|
||||
speed: 1.0
|
||||
});
|
||||
```
|
||||
|
||||
**Features**: Multiple voices, adjustable speed, various audio formats
|
||||
|
||||
---
|
||||
|
||||
### LLM (Large Language Model)
|
||||
**Command**: `LLM`
|
||||
|
||||
Chat completions with context management.
|
||||
|
||||
```javascript
|
||||
const completion = await zai.chat.completions.create({
|
||||
messages: [
|
||||
{ role: 'system', content: 'You are a helpful assistant.' },
|
||||
{ role: 'user', content: 'Hello!' }
|
||||
],
|
||||
temperature: 0.7
|
||||
});
|
||||
```
|
||||
|
||||
**Features**: Multi-turn conversations, system prompts, context management
|
||||
|
||||
---
|
||||
|
||||
### VLM (Vision Language Model)
|
||||
**Command**: `VLM`
|
||||
|
||||
Image understanding with conversational AI.
|
||||
|
||||
```javascript
|
||||
const response = await zai.vlm.analyze({
|
||||
image: imageUrlOrBase64,
|
||||
prompt: "Describe this image"
|
||||
});
|
||||
```
|
||||
|
||||
**Supports**: Image URLs, base64 encoded images, multimodal interactions
|
||||
|
||||
---
|
||||
|
||||
### Image Generation
|
||||
**Command**: `image-generation`
|
||||
|
||||
AI image creation from text.
|
||||
|
||||
```javascript
|
||||
const response = await zai.images.generations.create({
|
||||
prompt: 'A cute cat playing in the garden',
|
||||
size: '1024x1024'
|
||||
});
|
||||
|
||||
const imageBase64 = response.data[0].base64;
|
||||
```
|
||||
|
||||
**CLI Tool**:
|
||||
```bash
|
||||
z-ai-generate --prompt "A beautiful landscape" --output "./image.png"
|
||||
z-ai-generate -p "A cute cat" -o "./cat.png" -s 1024x1024
|
||||
```
|
||||
|
||||
**Supported Sizes**: 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720, 720x1440
|
||||
|
||||
---
|
||||
|
||||
### Image Edit
|
||||
**Command**: `image-edit`
|
||||
|
||||
Modify existing images with AI.
|
||||
|
||||
```javascript
|
||||
const edited = await zai.images.edits.create({
|
||||
image: originalImageBase64,
|
||||
prompt: "Add a sunset background"
|
||||
});
|
||||
```
|
||||
|
||||
**Use Cases**: Variations, redesign, text-based transformation
|
||||
|
||||
---
|
||||
|
||||
### Image Understand
|
||||
**Command**: `image-understand`
|
||||
|
||||
Analyze and understand images.
|
||||
|
||||
```javascript
|
||||
const analysis = await zai.image.understand({
|
||||
image: imagePath,
|
||||
task: "extract_text" // or "detect_objects", "classify"
|
||||
});
|
||||
```
|
||||
|
||||
**Supports**: PNG, JPEG, GIF, WebP, BMP
|
||||
|
||||
---
|
||||
|
||||
### Video Generation
|
||||
**Command**: `video-generation`
|
||||
|
||||
AI-powered video creation.
|
||||
|
||||
```javascript
|
||||
const task = await zai.videos.generations.create({
|
||||
prompt: "A dog running in a park",
|
||||
// or from image
|
||||
image: imageBase64
|
||||
});
|
||||
|
||||
// Async status polling
|
||||
const status = await zai.videos.generations.status(task.id);
|
||||
const result = await zai.videos.generations.retrieve(task.id);
|
||||
```
|
||||
|
||||
**Features**: Async task management, status polling, result retrieval
|
||||
|
||||
---
|
||||
|
||||
### Video Understand
|
||||
**Command**: `video-understand`
|
||||
|
||||
Analyze video content.
|
||||
|
||||
```javascript
|
||||
const analysis = await zai.video.analyze({
|
||||
video: videoPath,
|
||||
prompt: "Describe what happens in this video"
|
||||
});
|
||||
```
|
||||
|
||||
**Supports**: MP4, AVI, MOV
|
||||
|
||||
---
|
||||
|
||||
## Document Processing Skills
|
||||
|
||||
### PDF
|
||||
**Command**: `pdf`
|
||||
|
||||
Comprehensive PDF toolkit.
|
||||
|
||||
**Capabilities**:
|
||||
- Extract text and tables
|
||||
- Create new PDFs
|
||||
- Merge/split documents
|
||||
- Handle forms
|
||||
|
||||
---
|
||||
|
||||
### DOCX
|
||||
**Command**: `docx`
|
||||
|
||||
Word document processing.
|
||||
|
||||
**Capabilities**:
|
||||
- Create and edit documents
|
||||
- Tracked changes
|
||||
- Comments
|
||||
- Formatting preservation
|
||||
- Text extraction
|
||||
|
||||
---
|
||||
|
||||
### XLSX
|
||||
**Command**: `xlsx`
|
||||
|
||||
Spreadsheet processing.
|
||||
|
||||
**Capabilities**:
|
||||
- Create with formulas and formatting
|
||||
- Read and analyze data
|
||||
- Modify while preserving formulas
|
||||
- Data visualization
|
||||
- Formula recalculation
|
||||
|
||||
**Supports**: .xlsx, .xlsm, .csv, .tsv
|
||||
|
||||
---
|
||||
|
||||
### PPTX
|
||||
**Command**: `pptx`
|
||||
|
||||
Presentation processing.
|
||||
|
||||
**Capabilities**:
|
||||
- Edit existing presentations
|
||||
- Add slides
|
||||
- Create new presentations
|
||||
- Work with layouts
|
||||
- Add comments/speaker notes
|
||||
|
||||
---
|
||||
|
||||
## Web & Data Skills
|
||||
|
||||
### Web Search
|
||||
**Command**: `web-search`
|
||||
|
||||
Search for real-time information.
|
||||
|
||||
```javascript
|
||||
const results = await zai.functions.invoke("web_search", {
|
||||
query: "What is the capital of France?",
|
||||
num: 10
|
||||
});
|
||||
|
||||
// Result type
|
||||
interface SearchFunctionResultItem {
|
||||
url: string;
|
||||
name: string;
|
||||
snippet: string;
|
||||
host_name: string;
|
||||
rank: number;
|
||||
date: string;
|
||||
favicon: string;
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Web Reader
|
||||
**Command**: `web-reader`
|
||||
|
||||
Extract web page content.
|
||||
|
||||
```javascript
|
||||
const content = await zai.web.read({
|
||||
url: "https://example.com"
|
||||
});
|
||||
```
|
||||
|
||||
**Features**: Automatic content extraction, title, HTML, publication time
|
||||
|
||||
---
|
||||
|
||||
### CSV Data Summarizer
|
||||
**Command**: `csv-data-summarizer`
|
||||
|
||||
Automatic CSV analysis.
|
||||
|
||||
**Features**:
|
||||
- Detects data types (sales, customer, financial, operational, survey)
|
||||
- Generates correlation heatmaps
|
||||
- Time-series plots
|
||||
- Distribution charts
|
||||
- Missing data analysis
|
||||
- Automatic date detection
|
||||
|
||||
**Built with**: pandas, matplotlib, seaborn
|
||||
|
||||
---
|
||||
|
||||
### Deep Research
|
||||
**Command**: `deep-research`
|
||||
|
||||
Enterprise-grade research.
|
||||
|
||||
**Triggers**: "deep research", "comprehensive analysis", "research report", "compare X vs Y"
|
||||
|
||||
**Features**:
|
||||
- Multi-source synthesis
|
||||
- Citation tracking
|
||||
- Verification
|
||||
- 10+ sources
|
||||
|
||||
---
|
||||
|
||||
## Specialized Skills
|
||||
|
||||
### Podcast Generate
|
||||
**Command**: `podcast-generate`
|
||||
|
||||
Create podcast episodes.
|
||||
|
||||
**Modes**:
|
||||
1. From uploaded text/article → dual-host dialogue
|
||||
2. From topic → web search + generation
|
||||
|
||||
**Features**:
|
||||
- Duration scales with content (3-20 min, ~240 chars/min)
|
||||
- Outputs: Markdown script + WAV audio
|
||||
|
||||
---
|
||||
|
||||
### Story Video Generation
|
||||
**Command**: `story-video-generation`
|
||||
|
||||
Convert sentences to story videos.
|
||||
|
||||
**Triggers** (Chinese): "生成故事", "故事视频", "把一句话变成视频"
|
||||
|
||||
**Process**: Sentence → Story → Scene Images → Video
|
||||
|
||||
---
|
||||
|
||||
### Frontend Design
|
||||
**Command**: `frontend-design`
|
||||
|
||||
Transform UI requirements to production code.
|
||||
|
||||
**Features**:
|
||||
- Design tokens
|
||||
- Accessibility compliance
|
||||
- Creative execution
|
||||
|
||||
**Use Cases**: Websites, web apps, React/Vue components, dashboards, landing pages
|
||||
|
||||
---
|
||||
|
||||
### Finance
|
||||
**Command**: `finance`
|
||||
|
||||
Finance API integration.
|
||||
|
||||
**Capabilities**:
|
||||
- Stock price queries
|
||||
- Market data analysis
|
||||
- Company financials
|
||||
- Portfolio tracking
|
||||
- Market news
|
||||
- Stock screening
|
||||
- Technical analysis
|
||||
|
||||
---
|
||||
|
||||
### Gift Evaluator
|
||||
**Command**: `gift-evaluator`
|
||||
|
||||
Spring Festival gift analysis.
|
||||
|
||||
**Features**:
|
||||
- Visual perception
|
||||
- Market valuation
|
||||
- HTML card generation
|
||||
|
||||
**Use Cases**: Gift photos, value inquiry, authenticity, social responses
|
||||
|
||||
---
|
||||
|
||||
## Subagents (Task Tool)
|
||||
|
||||
### Available Agent Types
|
||||
|
||||
| Agent | Description | Tools |
|
||||
|-------|-------------|-------|
|
||||
| `general-purpose` | Complex research, multi-step tasks | All |
|
||||
| `statusline-setup` | Status line configuration | Read, Edit |
|
||||
| `Explore` | Codebase exploration | All |
|
||||
| `Plan` | Implementation planning | All |
|
||||
| `frontend-styling-expert` | CSS, styling, responsive design | All |
|
||||
| `full-stack-developer` | Next.js 15 + React + Prisma | All |
|
||||
|
||||
### Explore Agent Thoroughness
|
||||
- `quick`: Basic searches
|
||||
- `medium`: Moderate exploration
|
||||
- `very thorough`: Comprehensive analysis
|
||||
|
||||
---
|
||||
|
||||
## Project Environment
|
||||
|
||||
### Standard Stack
|
||||
- Next.js 15 with App Router
|
||||
- Port: 3000
|
||||
- Package manager: Bun
|
||||
- Database: Prisma
|
||||
- UI: shadcn/ui components
|
||||
|
||||
### Commands
|
||||
```bash
|
||||
bun run dev # Start dev server (auto-runs)
|
||||
bun run lint # Check code quality
|
||||
```
|
||||
|
||||
### File Output
|
||||
All generated files go to:
|
||||
```
|
||||
/home/z/my-project/download/
|
||||
```
|
||||
|
||||
### Backend-Only Rule
|
||||
`z-ai-web-dev-sdk` MUST be used in backend only (API routes, server components).
|
||||
|
||||
---
|
||||
|
||||
## Design Patterns
|
||||
|
||||
### Async Task Pattern (Video Generation)
|
||||
```javascript
|
||||
// 1. Create task
|
||||
const task = await create({ prompt });
|
||||
|
||||
// 2. Poll status
|
||||
const status = await status(task.id);
|
||||
|
||||
// 3. Retrieve result when complete
|
||||
const result = await retrieve(task.id);
|
||||
```
|
||||
|
||||
### Multi-Modal Input Pattern
|
||||
```javascript
|
||||
// Flexible input handling
|
||||
const input = {
|
||||
// Text only
|
||||
text: "description",
|
||||
|
||||
// Image only
|
||||
image: base64OrUrl,
|
||||
|
||||
// Mixed
|
||||
text: "modify this",
|
||||
image: base64OrUrl
|
||||
};
|
||||
```
|
||||
|
||||
### Function Invocation Pattern
|
||||
```javascript
|
||||
const result = await zai.functions.invoke("function_name", {
|
||||
param1: "value",
|
||||
param2: 123
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## When to Use This Reference
|
||||
|
||||
1. **Building AI-powered applications**: SDK patterns and examples
|
||||
2. **Document processing**: PDF/DOCX/XLSX/PPTX capabilities
|
||||
3. **Multimodal features**: Image, video, audio processing
|
||||
4. **Web integration**: Search and scraping patterns
|
||||
5. **Agent design**: Subagent patterns and capabilities
|
||||
|
||||
## Source
|
||||
- Platform: Super Z (z.ai)
|
||||
- SDK: z-ai-web-dev-sdk
|
||||
- Framework: Next.js 15 + React + Prisma
|
||||
- UI: shadcn/ui
|
||||
277
skills/minimax-experts/SKILL.md
Normal file
277
skills/minimax-experts/SKILL.md
Normal file
@@ -0,0 +1,277 @@
|
||||
---
|
||||
name: minimax-experts
|
||||
description: "Reference catalog of 40 AI experts from MiniMax platform. AUTO-TRIGGERS when: designing agents, content creation, finance/trading, marketing, job hunting, CV optimization, PRD generation, hedge fund analysis, crypto trading, landing pages, icon generation, visual content."
|
||||
priority: 100
|
||||
autoTrigger: true
|
||||
triggers:
|
||||
- "agent design"
|
||||
- "create an agent"
|
||||
- "expert system"
|
||||
- "hedge fund"
|
||||
- "trading agent"
|
||||
- "crypto trading"
|
||||
- "landing page"
|
||||
- "icon generation"
|
||||
- "content creation"
|
||||
- "PRD"
|
||||
- "product requirements"
|
||||
- "CV optimization"
|
||||
- "resume"
|
||||
- "job hunting"
|
||||
- "marketing"
|
||||
- "social media marketing"
|
||||
- "visual content"
|
||||
- "infographic"
|
||||
- "presentation"
|
||||
- "MiniMax"
|
||||
---
|
||||
|
||||
# MiniMax Expert Catalog Reference
|
||||
|
||||
This skill provides reference information about 40 AI experts available on the MiniMax platform. Use these patterns as inspiration for implementing similar capabilities.
|
||||
|
||||
## Categories Overview
|
||||
|
||||
- **Content Creation** (12 experts): Landing pages, visuals, videos, icons, stickers
|
||||
- **Finance** (7 experts): Hedge fund teams, trading, crypto analysis
|
||||
- **Development** (5 experts): Coding agents, prompt engineering, video dev
|
||||
- **Career** (5 experts): Job hunting, CV optimization, career planning
|
||||
- **Business** (3 experts): PRD, SaaS niches, CEO assistance
|
||||
- **Marketing** (2 experts): Social media, ad creative
|
||||
- **File Management** (2 experts): Folder organization
|
||||
- **Document Management** (2 experts): PDF/DOCX processing
|
||||
- **Education** (1 expert): Knowledge conversion
|
||||
|
||||
---
|
||||
|
||||
## Top Experts by Popularity
|
||||
|
||||
### 1. Landing Page Builder
|
||||
- **Views**: 9,719 | **Category**: Content Creation
|
||||
- **Description**: Professional high-end Landing Page generation, creating visually stunning web pages
|
||||
- **Pattern**: Use for: marketers, entrepreneurs, businesses needing landing pages without design expertise
|
||||
|
||||
### 2. Visual Lab
|
||||
- **Views**: 3,868 | **Category**: Content Creation
|
||||
- **Description**: Professional visual content generation - presentations, infographics, charts, dashboards, timelines, flowcharts, mind maps
|
||||
- **Pattern**: Multi-purpose visual creation tool with AI image generation
|
||||
|
||||
### 3. Tidy Folder
|
||||
- **Views**: 3,172 | **Category**: File Management
|
||||
- **Description**: Folder organization with automatic compressed backups, uses move instead of delete for safety
|
||||
- **Pattern**: Safety-first file operations, cross-platform support
|
||||
|
||||
### 4. Video Story Generator
|
||||
- **Views**: 2,816 | **Category**: Content Creation
|
||||
- **Description**: Generates video stories from images or text, flexible input (1-N images/pure text/mixed)
|
||||
- **Pattern**: Multi-modal input processing, style selection
|
||||
|
||||
### 5. GIF Sticker Maker
|
||||
- **Views**: 1,926 | **Category**: Content Creation
|
||||
- **Description**: Converts photos to cartoon stickers, animated GIF stickers with captions, bobblehead style
|
||||
- **Pattern**: One-click batch generation (4 variations), adaptive language
|
||||
|
||||
### 6. Icon Maker
|
||||
- **Views**: 1,792 | **Category**: Content Creation
|
||||
- **Description**: AI icon generator for Apps, websites, games, brand logos, social avatars
|
||||
- **Pattern**: 20+ style options, random recommendations
|
||||
|
||||
### 7. Hedge Fund Expert Team (Chinese/English)
|
||||
- **Views**: 1,778/326 | **Category**: Finance
|
||||
- **Description**: 18 top investment experts - 12 masters (Buffett, Munger, Damodaran) + 6 analysts (valuation, sentiment, fundamentals, technical, risk, portfolio)
|
||||
- **Pattern**: Multi-agent collaboration for comprehensive analysis
|
||||
|
||||
### 8. Doc Processor
|
||||
- **Views**: 1,636 | **Category**: Document Management
|
||||
- **Description**: PDF and DOCX creation, conversion, content refinement - full document lifecycle
|
||||
- **Pattern**: Universal document processing
|
||||
|
||||
### 9. AI Trading Consortium
|
||||
- **Views**: 1,075 | **Category**: Finance
|
||||
- **Description**: Multi-expert trading strategies with famous investor perspectives (Buffett, Lynch, Burry)
|
||||
- **Pattern**: Perspective diversity, comprehensive information gathering
|
||||
|
||||
### 10. PRD Assistant
|
||||
- **Views**: 822 | **Category**: Business
|
||||
- **Description**: Product requirements analysis and PRD generation with optional HTML prototype
|
||||
- **Pattern**: End-to-end from idea to prototype
|
||||
|
||||
### 11. Crypto Trading Agent
|
||||
- **Views**: 775 | **Category**: Finance
|
||||
- **Description**: Multi-layer analysis (Macro Gatekeeper, Anti-Consensus Filter, SFP Liquidity Hunter, Committee Decision, Risk Governor)
|
||||
- **Pattern**: Survival over profit, binary output (EXECUTE/NO TRADE)
|
||||
|
||||
### 12. Topic Tracker
|
||||
- **Views**: 572 | **Category**: Content Creation
|
||||
- **Description**: Searches latest sources, discovers trending topics, generates long-form content
|
||||
- **Pattern**: Real-time trend analysis, content synthesis
|
||||
|
||||
### 13. Knowledge Digest
|
||||
- **Views**: 478 | **Category**: Education
|
||||
- **Description**: Converts textbooks/PDFs into multimodal learning materials - notes, quizzes, slides, audio, mind maps
|
||||
- **Pattern**: Multi-format output, personalized learning
|
||||
|
||||
### 14. Mini Coder Max
|
||||
- **Views**: 437 | **Category**: Development
|
||||
- **Description**: Autonomous coding agent that spawns multiple subagents in parallel
|
||||
- **Pattern**: Parallel subagent execution for complex tasks
|
||||
|
||||
### 15. CEO Assistant
|
||||
- **Views**: 210 | **Category**: Business
|
||||
- **Description**: Master AI assistant for executives - planning, execution, decision-making support
|
||||
- **Pattern**: End-to-end project management
|
||||
|
||||
---
|
||||
|
||||
## Development Experts
|
||||
|
||||
### Mini Coder Max
|
||||
Autonomous coding with parallel subagent spawning for complex development tasks.
|
||||
|
||||
### Peak Coder
|
||||
Autonomous software engineering engine delivering production-ready codebases through checklist-driven development.
|
||||
|
||||
### Prompt Development Studio
|
||||
Expert system for designing, analyzing, and optimizing prompts across AI models.
|
||||
|
||||
### Remotion Video Assistant
|
||||
Professional Remotion video development - React-based video creation, animations, compositions.
|
||||
|
||||
### nano banana pro json prompt generator
|
||||
JSON prompt generator for structured prompts.
|
||||
|
||||
---
|
||||
|
||||
## Finance Experts
|
||||
|
||||
### Hedge Fund Expert Team (Chinese + English versions)
|
||||
18-expert team: 12 investment masters + 6 professional analysts.
|
||||
|
||||
### AI Trading Consortium
|
||||
Multi-expert trading with famous investor perspective simulation.
|
||||
|
||||
### Crypto Trading Agent
|
||||
Professional BTC/ETH/SOL trading with multi-layer analysis.
|
||||
|
||||
### Quant Trading Strategist
|
||||
Options/futures/securities analysis, quantitative strategy design, backtesting.
|
||||
|
||||
### SaaS Niche Finder
|
||||
Discovers profitable SaaS niches, validates business ideas with market research.
|
||||
|
||||
---
|
||||
|
||||
## Career Experts
|
||||
|
||||
### Job Hunter Agent
|
||||
Comprehensive job hunting across all global platforms, auto-application, tracking.
|
||||
|
||||
### CV Optimization Expert
|
||||
Career Architect for 2025 job market, ATS compliance, keyword optimization.
|
||||
|
||||
### Student Career Planner
|
||||
Career planning, path exploration, skill gap analysis, future self conversations.
|
||||
|
||||
### Upwork DNA Optimizer
|
||||
Market intelligence for freelancers, profile optimization, job matching.
|
||||
|
||||
### Frontend Interview Expert
|
||||
Generates targeted technical interview questions from candidate resumes.
|
||||
|
||||
---
|
||||
|
||||
## Marketing Experts
|
||||
|
||||
### Social Media Marketing Expert
|
||||
TikTok and Meta ads specialist - campaign strategy, creative, targeting, optimization.
|
||||
|
||||
### Creative Director For Ads
|
||||
Performance ad content director - traffic ads, inquiry ads, social media materials.
|
||||
|
||||
---
|
||||
|
||||
## Content Creation Experts
|
||||
|
||||
### Landing Page Builder
|
||||
Professional high-end landing pages.
|
||||
|
||||
### Visual Lab
|
||||
Multi-format visual content - presentations, charts, dashboards, infographics.
|
||||
|
||||
### Video Story Generator
|
||||
Video from images/text with selectable duration and style.
|
||||
|
||||
### GIF Sticker Maker
|
||||
Cartoon stickers, animated GIFs with captions, bobblehead style.
|
||||
|
||||
### Icon Maker
|
||||
Professional icons for all platforms, 20+ styles.
|
||||
|
||||
### Topic Tracker
|
||||
Trending topic discovery and long-form content generation.
|
||||
|
||||
### Image Craft / Image Craft Pro
|
||||
Curated image generation prompts - figures, scenes, products, style transformation.
|
||||
|
||||
### AI Novel Writer
|
||||
Web novel writing - fast-paced, addictive serialized fiction.
|
||||
|
||||
### Chinese Xianxia Novel Expert
|
||||
Chinese fantasy novel creation with classical prose and poetry.
|
||||
|
||||
### Gradient Generator
|
||||
Random gradients - SVG layered radial or AI-generated.
|
||||
|
||||
### 1-Image-to-9-Cinematic-Angles
|
||||
Transform single image into 9 cinematic camera angles.
|
||||
|
||||
### Daily Trending Articles Collector
|
||||
Global trending article collection and summarization.
|
||||
|
||||
### Content Creator
|
||||
Topic-to-Notion pipeline with automatic image generation.
|
||||
|
||||
---
|
||||
|
||||
## Design Patterns from MiniMax Experts
|
||||
|
||||
### Multi-Agent Teams
|
||||
- Hedge Fund Expert: 18 specialists in one team
|
||||
- Use for: complex analysis requiring multiple perspectives
|
||||
|
||||
### Safety-First Operations
|
||||
- Tidy Folder: automatic backups, move not delete
|
||||
- Use for: destructive operations, file management
|
||||
|
||||
### One-to-Many Generation
|
||||
- GIF Sticker Maker: 4 variations in one click
|
||||
- 1-Image-to-9-Cinematic-Angles: single input, multiple outputs
|
||||
- Use for: creative exploration, A/B testing
|
||||
|
||||
### Perspective Simulation
|
||||
- AI Trading Consortium: simulates Buffett, Lynch, Burry
|
||||
- Use for: decision validation, bias checking
|
||||
|
||||
### Binary Decision Systems
|
||||
- Crypto Trading Agent: EXECUTE or NO TRADE only
|
||||
- Use for: risk management, clear action signals
|
||||
|
||||
### Multi-Format Output
|
||||
- Knowledge Digest: notes, quizzes, slides, audio, mind maps
|
||||
- PRD Assistant: document + optional HTML prototype
|
||||
- Use for: reaching different audiences, comprehensive delivery
|
||||
|
||||
---
|
||||
|
||||
## When to Use This Reference
|
||||
|
||||
1. **Designing new agents/skills**: Look at similar experts for inspiration
|
||||
2. **Understanding capabilities**: See what's possible with AI agents
|
||||
3. **Pattern matching**: Find the right approach for your use case
|
||||
4. **Feature ideas**: Discover useful functionality patterns
|
||||
|
||||
## Source
|
||||
- Platform: https://agent.minimax.io/experts
|
||||
- Total Experts: 40
|
||||
- Total Views: 36,891
|
||||
- Extraction Date: 2026-02-12
|
||||
427
skills/zai-tooling-reference/SKILL.md
Normal file
427
skills/zai-tooling-reference/SKILL.md
Normal file
@@ -0,0 +1,427 @@
|
||||
---
|
||||
name: zai-tooling-reference
|
||||
description: "Complete z.ai tooling reference - Next.js 15/16, React 19, shadcn/ui, Prisma, WebSocket. AUTO-TRIGGERS when: Next.js setup, shadcn/ui components, Prisma schema, SQLite, WebSocket/Socket.io, Zustand state, TanStack Query, NextAuth, Tailwind CSS 4, Bun, full-stack development."
|
||||
priority: 100
|
||||
autoTrigger: true
|
||||
triggers:
|
||||
- "Next.js"
|
||||
- "nextjs"
|
||||
- "shadcn"
|
||||
- "shadcn/ui"
|
||||
- "Prisma"
|
||||
- "SQLite"
|
||||
- "WebSocket"
|
||||
- "socket.io"
|
||||
- "real-time"
|
||||
- "Zustand"
|
||||
- "TanStack Query"
|
||||
- "react-query"
|
||||
- "NextAuth"
|
||||
- "authentication"
|
||||
- "Tailwind"
|
||||
- "Tailwind CSS 4"
|
||||
- "Bun"
|
||||
- "React 19"
|
||||
- "full-stack"
|
||||
- "frontend component"
|
||||
- "UI component"
|
||||
- "database schema"
|
||||
---
|
||||
|
||||
# Z.AI Tooling Reference
|
||||
|
||||
Complete technical reference for the z.ai tooling codebase - a production-ready Next.js 15 application with AI capabilities.
|
||||
|
||||
**Codebase Location**: `~/reference-codebases/z-ai-tooling/`
|
||||
|
||||
---
|
||||
|
||||
## Tech Stack
|
||||
|
||||
| Category | Technology | Version |
|
||||
|----------|------------|---------|
|
||||
| Framework | Next.js | 16.1.1 |
|
||||
| React | React | 19.0.0 |
|
||||
| Language | TypeScript | 5.x |
|
||||
| Styling | Tailwind CSS | 4.x |
|
||||
| UI Components | shadcn/ui (Radix) | Latest |
|
||||
| Database | Prisma + SQLite | 6.11.1 |
|
||||
| State | Zustand | 5.0.6 |
|
||||
| Data Fetching | TanStack Query | 5.82.0 |
|
||||
| AI SDK | z-ai-web-dev-sdk | 0.0.16 |
|
||||
| Auth | NextAuth | 4.24.11 |
|
||||
| Package Manager | Bun | 1.3.4+ |
|
||||
|
||||
---
|
||||
|
||||
## Project Structure
|
||||
|
||||
```
|
||||
z-ai-tooling/
|
||||
├── src/
|
||||
│ ├── app/ # Next.js App Router
|
||||
│ │ ├── api/route.ts # API endpoints
|
||||
│ │ ├── page.tsx # Main page
|
||||
│ │ ├── layout.tsx # Root layout
|
||||
│ │ └── globals.css # Global styles
|
||||
│ ├── components/
|
||||
│ │ └── ui/ # shadcn/ui components (50+)
|
||||
│ ├── hooks/
|
||||
│ │ ├── use-mobile.ts # Mobile detection
|
||||
│ │ └── use-toast.ts # Toast notifications
|
||||
│ └── lib/
|
||||
│ ├── db.ts # Prisma client singleton
|
||||
│ └── utils.ts # Utility functions (cn, etc.)
|
||||
├── prisma/
|
||||
│ └── schema.prisma # Database schema
|
||||
├── examples/
|
||||
│ └── websocket/ # WebSocket implementation
|
||||
├── db/
|
||||
│ └── custom.db # SQLite database
|
||||
├── download/ # Output directory for generated files
|
||||
└── .zscripts/ # Build and start scripts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Database Patterns
|
||||
|
||||
### Prisma Schema
|
||||
|
||||
```prisma
|
||||
generator client {
|
||||
provider = "prisma-client-js"
|
||||
}
|
||||
|
||||
datasource db {
|
||||
provider = "sqlite"
|
||||
url = env("DATABASE_URL")
|
||||
}
|
||||
|
||||
model User {
|
||||
id String @id @default(cuid())
|
||||
email String @unique
|
||||
name String?
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
}
|
||||
|
||||
model Post {
|
||||
id String @id @default(cuid())
|
||||
title String
|
||||
content String?
|
||||
published Boolean @default(false)
|
||||
authorId String
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
}
|
||||
```
|
||||
|
||||
### Database Client Singleton
|
||||
|
||||
```typescript
|
||||
// src/lib/db.ts
|
||||
import { PrismaClient } from '@prisma/client'
|
||||
|
||||
const globalForPrisma = globalThis as unknown as {
|
||||
prisma: PrismaClient | undefined
|
||||
}
|
||||
|
||||
export const db =
|
||||
globalForPrisma.prisma ??
|
||||
new PrismaClient({
|
||||
log: ['query'],
|
||||
})
|
||||
|
||||
if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = db
|
||||
```
|
||||
|
||||
### Database Commands
|
||||
|
||||
```bash
|
||||
bun run db:push # Push schema changes
|
||||
bun run db:generate # Generate Prisma client
|
||||
bun run db:migrate # Create migration
|
||||
bun run db:reset # Reset database
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## WebSocket Integration
|
||||
|
||||
### Server (Socket.io)
|
||||
|
||||
```typescript
|
||||
// examples/websocket/server.ts
|
||||
import { createServer } from 'http'
|
||||
import { Server } from 'socket.io'
|
||||
|
||||
const httpServer = createServer()
|
||||
const io = new Server(httpServer, {
|
||||
path: '/',
|
||||
cors: { origin: "*", methods: ["GET", "POST"] },
|
||||
pingTimeout: 60000,
|
||||
pingInterval: 25000,
|
||||
})
|
||||
|
||||
interface User { id: string; username: string }
|
||||
interface Message {
|
||||
id: string
|
||||
username: string
|
||||
content: string
|
||||
timestamp: Date
|
||||
type: 'user' | 'system'
|
||||
}
|
||||
|
||||
const users = new Map<string, User>()
|
||||
|
||||
io.on('connection', (socket) => {
|
||||
socket.on('join', (data: { username: string }) => {
|
||||
const user: User = { id: socket.id, username: data.username }
|
||||
users.set(socket.id, user)
|
||||
io.emit('user-joined', { user, message: createSystemMessage(`${data.username} joined`) })
|
||||
socket.emit('users-list', { users: Array.from(users.values()) })
|
||||
})
|
||||
|
||||
socket.on('message', (data: { content: string; username: string }) => {
|
||||
const message = createUserMessage(data.username, data.content)
|
||||
io.emit('message', message)
|
||||
})
|
||||
|
||||
socket.on('disconnect', () => {
|
||||
const user = users.get(socket.id)
|
||||
if (user) {
|
||||
users.delete(socket.id)
|
||||
io.emit('user-left', { user, message: createSystemMessage(`${user.username} left`) })
|
||||
}
|
||||
})
|
||||
})
|
||||
|
||||
httpServer.listen(3003)
|
||||
```
|
||||
|
||||
### Client (React)
|
||||
|
||||
```typescript
|
||||
// examples/websocket/frontend.tsx
|
||||
'use client';
|
||||
|
||||
import { useEffect, useState } from 'react';
|
||||
import { io } from 'socket.io-client';
|
||||
|
||||
export default function SocketDemo() {
|
||||
const [socket, setSocket] = useState<any>(null);
|
||||
const [isConnected, setIsConnected] = useState(false);
|
||||
|
||||
useEffect(() => {
|
||||
// Use XTransformPort instead of direct port
|
||||
const socketInstance = io('/?XTransformPort=3003', {
|
||||
transports: ['websocket', 'polling'],
|
||||
reconnection: true,
|
||||
reconnectionAttempts: 5,
|
||||
reconnectionDelay: 1000,
|
||||
});
|
||||
|
||||
setSocket(socketInstance);
|
||||
|
||||
socketInstance.on('connect', () => setIsConnected(true));
|
||||
socketInstance.on('disconnect', () => setIsConnected(false));
|
||||
socketInstance.on('message', (msg) => { /* handle message */ });
|
||||
|
||||
return () => socketInstance.disconnect();
|
||||
}, []);
|
||||
|
||||
return ( /* JSX */ );
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Available UI Components (shadcn/ui)
|
||||
|
||||
50+ components available in `src/components/ui/`:
|
||||
|
||||
| Component | File | Purpose |
|
||||
|-----------|------|---------|
|
||||
| Button | button.tsx | Primary actions |
|
||||
| Input | input.tsx | Text input |
|
||||
| Card | card.tsx | Container |
|
||||
| Dialog | dialog.tsx | Modal |
|
||||
| Sheet | sheet.tsx | Side panel |
|
||||
| Toast | toast.tsx | Notifications |
|
||||
| Select | select.tsx | Dropdown |
|
||||
| Table | table.tsx | Data tables |
|
||||
| Tabs | tabs.tsx | Tab navigation |
|
||||
| Form | form.tsx | Form handling |
|
||||
| Chart | chart.tsx | Charts (Recharts) |
|
||||
| Calendar | calendar.tsx | Date picker |
|
||||
| Command | command.tsx | Command palette |
|
||||
| Drawer | drawer.tsx | Mobile drawer |
|
||||
| Sidebar | sidebar.tsx | Navigation sidebar |
|
||||
| Carousel | carousel.tsx | Image carousel |
|
||||
| Accordion | accordion.tsx | Collapsible content |
|
||||
| Avatar | avatar.tsx | User avatars |
|
||||
| Badge | badge.tsx | Status indicators |
|
||||
| Checkbox | checkbox.tsx | Boolean input |
|
||||
| Slider | slider.tsx | Range input |
|
||||
| Switch | switch.tsx | Toggle |
|
||||
| Tooltip | tooltip.tsx | Hover info |
|
||||
| Progress | progress.tsx | Loading indicator |
|
||||
| Skeleton | skeleton.tsx | Loading placeholder |
|
||||
| ScrollArea | scroll-area.tsx | Scrollable container |
|
||||
|
||||
---
|
||||
|
||||
## Dependencies Overview
|
||||
|
||||
### Core Dependencies
|
||||
|
||||
```json
|
||||
{
|
||||
"next": "^16.1.1",
|
||||
"react": "^19.0.0",
|
||||
"react-dom": "^19.0.0",
|
||||
"z-ai-web-dev-sdk": "^0.0.16",
|
||||
"prisma": "^6.11.1",
|
||||
"@prisma/client": "^6.11.1"
|
||||
}
|
||||
```
|
||||
|
||||
### UI Dependencies
|
||||
|
||||
```json
|
||||
{
|
||||
"@radix-ui/react-*": "latest", // All Radix primitives
|
||||
"lucide-react": "^0.525.0", // Icons
|
||||
"framer-motion": "^12.23.2", // Animations
|
||||
"class-variance-authority": "^0.7.1",
|
||||
"clsx": "^2.1.1",
|
||||
"tailwind-merge": "^3.3.1"
|
||||
}
|
||||
```
|
||||
|
||||
### State & Data
|
||||
|
||||
```json
|
||||
{
|
||||
"zustand": "^5.0.6",
|
||||
"@tanstack/react-query": "^5.82.0",
|
||||
"@tanstack/react-table": "^8.21.3",
|
||||
"zod": "^4.0.2",
|
||||
"react-hook-form": "^7.60.0"
|
||||
}
|
||||
```
|
||||
|
||||
### Special Features
|
||||
|
||||
```json
|
||||
{
|
||||
"next-auth": "^4.24.11", // Authentication
|
||||
"next-intl": "^4.3.4", // Internationalization
|
||||
"next-themes": "^0.4.6", // Dark mode
|
||||
"recharts": "^2.15.4", // Charts
|
||||
"@mdxeditor/editor": "^3.39.1", // MDX editing
|
||||
"sharp": "^0.34.3" // Image optimization
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Scripts
|
||||
|
||||
```bash
|
||||
# Development
|
||||
bun run dev # Start on port 3000 with logging
|
||||
|
||||
# Production
|
||||
bun run build # Build with standalone output
|
||||
bun run start # Run production server
|
||||
|
||||
# Database
|
||||
bun run db:push # Push schema
|
||||
bun run db:generate # Generate client
|
||||
bun run db:migrate # Create migration
|
||||
bun run db:reset # Reset database
|
||||
|
||||
# Quality
|
||||
bun run lint # ESLint check
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File Output Pattern
|
||||
|
||||
Generated files are saved to:
|
||||
```
|
||||
/home/z/my-project/download/
|
||||
```
|
||||
|
||||
Or in this reference codebase:
|
||||
```
|
||||
~/reference-codebases/z-ai-tooling/download/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Key Patterns
|
||||
|
||||
### 1. Prisma Singleton
|
||||
Prevents multiple PrismaClient instances in development.
|
||||
|
||||
### 2. WebSocket Port Transformation
|
||||
Use `XTransformPort` query param instead of direct port numbers.
|
||||
|
||||
### 3. Component Structure
|
||||
All UI components use:
|
||||
- `cva` (class-variance-authority) for variants
|
||||
- `cn` utility for class merging
|
||||
- Radix primitives for accessibility
|
||||
|
||||
### 4. API Routes
|
||||
```typescript
|
||||
// src/app/api/route.ts
|
||||
import { NextResponse } from "next/server";
|
||||
|
||||
export async function GET() {
|
||||
return NextResponse.json({ message: "Hello, world!" });
|
||||
}
|
||||
```
|
||||
|
||||
### 5. Backend-Only SDK Usage
|
||||
`z-ai-web-dev-sdk` MUST only be used in:
|
||||
- API routes (`src/app/api/`)
|
||||
- Server components
|
||||
- Server actions
|
||||
|
||||
---
|
||||
|
||||
## When to Use This Reference
|
||||
|
||||
1. **Building Next.js 15 apps**: Project structure and patterns
|
||||
2. **shadcn/ui implementation**: Component usage examples
|
||||
3. **WebSocket integration**: Real-time features
|
||||
4. **Prisma + SQLite**: Database patterns
|
||||
5. **AI SDK integration**: z-ai-web-dev-sdk patterns
|
||||
6. **Production deployment**: Build and start scripts
|
||||
|
||||
---
|
||||
|
||||
## Quick Commands
|
||||
|
||||
```bash
|
||||
# Navigate to reference codebase
|
||||
cd ~/reference-codebases/z-ai-tooling
|
||||
|
||||
# Install dependencies
|
||||
bun install
|
||||
|
||||
# Start development
|
||||
bun run dev
|
||||
|
||||
# Check components
|
||||
ls src/components/ui/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
*Reference codebase copied from: C:\Users\admin\Documents\trae_projects\Skills and Agents\z.ai tooling*
|
||||
Reference in New Issue
Block a user