Initial commit: last30days-kimi with kimi_search support

2026-02-18 08:51:30 +08:00
commit 4d9d306cd2
4 changed files with 430 additions and 0 deletions
@@ -0,0 +1,120 @@
+# last30days-kimi
+
+Updated Claude Code skills that use `kimi_search` instead of requiring multiple API keys.
+
+## Skills Included
+
+### 1. last30days-kimi
+Research topics across Reddit and web from the last 30 days.
+
+**Original:** Required OpenAI API + XAI/Bird CLI  
+**This version:** Uses `kimi_search` - no additional keys needed
+
+### 2. x-trends
+Get trending topics from X (Twitter) via web search.
+
+**Approach:** Finds articles about X trends since direct API is expensive
+
+## Quick Start
+
+```bash
+# Install both skills
+git clone https://github.com/AlexMikhalev/last30days-skill.git ~/.claude/skills/last30days-kimi
+
+# Or copy to your skills directory
+cp -r last30days-kimi ~/.claude/skills/
+```
+
+## Usage
+
+### last30days-kimi
+```
+/last30days-kimi [topic] [for tool]
+
+Examples:
+/last30days-kimi prompting techniques for ChatGPT
+/last30days-kimi iOS app mockups for Claude Code
+/last30days-kimi What are the best rap songs lately
+```
+
+### x-trends
+```
+/x-trends                    # Current trending topics
+/x-trends [topic]            # Research specific topic
+/x-trends --category=tech    # Filter by category
+
+Examples:
+/x-trends AI
+/x-trends politics
+/x-trends --category=entertainment
+```
+
+## How It Works
+
+Both skills leverage `kimi_search` which is built into Kimi Claw:
+
+1. **No API keys needed** - Uses existing search capability
+2. **Reddit + Web sources** - Comprehensive coverage
+3. **Fresh content** - Recent discussions and articles
+4. **Simplified deployment** - Just clone and use
+
+## Comparison with Original
+
+| Feature | Original last30days | last30days-kimi | x-trends |
+|---------|---------------------|-----------------|----------|
+| **API Keys** | OpenAI + XAI/Bird | None | None |
+| **Reddit** | API required | ✅ kimi_search | N/A |
+| **X/Twitter** | ✅ Direct API | ❌ Not available | ✅ Web articles |
+| **Setup** | Complex | Simple | Simple |
+| **Cost** | $$ | Free | Free |
+| **Real-time** | ✅ Yes | ⚠️ Slight delay | ⚠️ Slight delay |
+
+## Limitations
+
+1. **No direct X access** - Uses web articles about X instead
+2. **Less real-time** - Small delay vs direct APIs
+3. **No engagement metrics** - Cannot fetch exact counts
+4. **Coverage** - Very recent content may not be indexed
+
+## When to Use
+
+**Use last30days-kimi when:**
+- You want Reddit + web research
+- You need current prompting techniques
+- You want to avoid API key setup
+
+**Use x-trends when:**
+- You need X trend awareness
+- You want trending topics overview
+- Direct X API is too expensive
+
+**Use original last30days when:**
+- You need real-time X data
+- You require exact engagement metrics
+- You have budget for API access
+
+## File Structure
+
+```
+last30days-kimi/
+├── SKILL.md                    # Main skill definition
+├── last30days-kimi.sh          # Helper script
+├── README.md                   # This file
+└── x-trends/
+    └── SKILL.md                # X trends skill
+```
+
+## Future Plans
+
+- [ ] Add caching for faster repeated queries
+- [ ] Trend velocity tracking
+- [ ] Sentiment analysis
+- [ ] More specialized sources
+- [ ] Integration with progress.md tracking
+
+## Credits
+
+Based on the excellent `last30days-skill` by @mvanhorn:  
+https://github.com/mvanhorn/last30days-skill
+
+Modified for Kimi Claw environment with `kimi_search` support.
@@ -0,0 +1,117 @@
+---
+name: last30days-kimi
+description: |
+  Research any topic across Reddit and the web from the last 30 days using kimi_search.
+  Updated version that works without Brave API by leveraging kimi_search capabilities.
+  Generates copy-paste-ready prompts based on current trends and discussions.
+license: Apache-2.0
+---
+
+# /last30days-kimi
+
+A Claude Code skill that researches topics across Reddit and the web from the last 30 days using `kimi_search`, then generates copy-paste-ready prompts.
+
+## Why This Version?
+
+The original `last30days-skill` requires:
+- OpenAI API key
+- XAI API key or Bird CLI
+- Reddit API access
+
+This updated version uses **`kimi_search`** which:
+- ✅ Works without additional API keys
+- ✅ Searches Reddit, web, and news sources
+- ✅ Provides fresh content from recent dates
+- ✅ Simpler setup and configuration
+
+## Installation
+
+```bash
+# Clone to Claude Code skills directory
+git clone https://github.com/AlexMikhalev/last30days-skill.git ~/.claude/skills/last30days-kimi
+```
+
+## Usage
+
+```
+/last30days-kimi [topic]
+/last30days-kimi [topic] for [tool]
+```
+
+### Examples:
+
+- `/last30days-kimi prompting techniques for ChatGPT`
+- `/last30days-kimi iOS app mockups for Claude Code`
+- `/last30days-kimi What are the best rap songs lately`
+- `/last30days-kimi remotion animations for Claude Code`
+
+## What It Does
+
+1. **Researches** - Scans Reddit and web for discussions from the last 30 days using `kimi_search`
+2. **Synthesizes** - Identifies patterns, best practices, and what actually works
+3. **Delivers** - Writes copy-paste-ready prompts for your target tool
+
+## Key Features
+
+- **No API keys required** - Uses `kimi_search` built into Kimi Claw
+- **Reddit + Web sources** - Searches both community discussions and web content
+- **Fresh content** - Focuses on last 30 days of discussions
+- **Prompt generation** - Creates ready-to-use prompts based on current trends
+
+## Workflow
+
+```
+User: /last30days-kimi nano banana pro prompting
+
+Skill:
+1. Search: "nano banana pro prompting reddit"
+2. Search: "nano banana pro techniques web"
+3. Analyze: Find patterns in recent discussions
+4. Generate: JSON-structured prompt based on community best practices
+```
+
+## Comparison with Original
+
+| Feature | Original last30days | last30days-kimi |
+|---------|---------------------|-----------------|
+| **API Keys** | OpenAI + XAI/Bird | None needed |
+| **Reddit Access** | API required | Via kimi_search |
+| **X/Twitter** | xAI API or Bird CLI | Not available* |
+| **Web Search** | OpenAI web search | kimi_search |
+| **Setup** | Complex (.env, auth) | Simple (clone only) |
+
+*Note: X/Twitter trends not available via kimi_search. Use web search for X-related discussions.
+
+## X Trends Alternative
+
+Since `kimi_search` doesn't directly access X/Twitter, for X trends use:
+```
+/last30days-kimi "trending on X Twitter [topic]"
+```
+
+This will find web articles and discussions about X trends.
+
+## Requirements
+
+- Kimi Claw with `kimi_search` capability
+- No additional API keys needed
+
+## Limitations
+
+1. **No direct X/Twitter access** - Uses web articles about X instead
+2. **Less real-time** - May be slightly less current than direct API access
+3. **No engagement metrics** - Cannot fetch upvote/like counts directly
+
+## Future Enhancements
+
+- [ ] Add X trends via alternative methods
+- [ ] Cache search results for faster repeated queries
+- [ ] Add engagement estimation from search results
+- [ ] Support for more specialized sources
+
+## Credits
+
+Based on the original `last30days-skill` by @mvanhorn:
+https://github.com/mvanhorn/last30days-skill
+
+Modified to use `kimi_search` for simplified deployment.
@@ -0,0 +1,49 @@
+#!/bin/bash
+# last30days-kimi - Research topics using kimi_search
+# Simplified version that works without additional API keys
+
+set -euo pipefail
+
+# Get topic from arguments
+TOPIC="${1:-}"
+TOOL="${2:-}"
+
+if [ -z "$TOPIC" ]; then
+    echo "Usage: /last30days-kimi [topic] [optional: for tool]"
+    echo "Example: /last30days-kimi prompting techniques for ChatGPT"
+    exit 1
+fi
+
+echo "🔍 Researching: $TOPIC"
+echo "📅 Timeframe: Last 30 days"
+echo ""
+
+# Build search queries
+REDDIT_QUERY="$TOPIC reddit discussions"
+WEB_QUERY="$TOPIC trending 2026"
+
+if [ -n "$TOOL" ]; then
+    REDDIT_QUERY="$TOPIC $TOOL reddit"
+    WEB_QUERY="$TOPIC $TOOL best practices"
+fi
+
+echo "📝 Search queries:"
+echo "  - Reddit: $REDDIT_QUERY"
+echo "  - Web: $WEB_QUERY"
+echo ""
+
+# Note: This is a template script
+# In actual usage, Claude Code will use kimi_search tool directly
+# based on the SKILL.md instructions
+
+echo "✅ Skill template ready"
+echo ""
+echo "To use this skill:"
+echo "1. Claude Code will read SKILL.md"
+echo "2. It will use kimi_search with queries like:"
+echo "   kimi_search '$REDDIT_QUERY'"
+echo "   kimi_search '$WEB_QUERY'"
+echo "3. Synthesize results and generate prompt"
+echo ""
+echo "Topic: $TOPIC"
+[ -n "$TOOL" ] && echo "Tool: $TOOL"
@@ -0,0 +1,144 @@
+---
+name: x-trends
+description: |
+  Get trending topics from X (Twitter) using web search.
+  Finds what's trending on X by searching web articles and discussions about X trends.
+  Provides current trending topics, hashtags, and viral content analysis.
+license: Apache-2.0
+---
+
+# /x-trends
+
+Get trending topics from X (Twitter) using web search via `kimi_search`.
+
+## Why This Approach?
+
+Direct X/Twitter API access requires:
+- X API key (expensive, limited access)
+- xAI API key for Grok
+- Bird CLI (requires authentication)
+
+This skill uses **web search** to find:
+- Articles about what's trending on X
+- Discussions about viral X posts
+- Trending hashtags and topics
+- X trend roundups and summaries
+
+## Usage
+
+```
+/x-trends                    # Get current X trending topics
+/x-trends [topic]            # Research specific topic on X
+/x-trends --category=tech    # Filter by category
+```
+
+### Examples:
+
+- `/x-trends` - Current trending topics on X
+- `/x-trends AI` - What's trending about AI on X
+- `/x-trends politics` - Political trends on X
+- `/x-trends --category=tech` - Tech trends only
+
+## Categories
+
+- `tech` - Technology, AI, programming
+- `politics` - Political discussions
+- `entertainment` - Movies, music, celebrities
+- `sports` - Sports events and athletes
+- `business` - Finance, markets, business
+- `general` - All trending topics
+
+## What It Returns
+
+1. **Top Trending Topics** - Most discussed subjects on X
+2. **Viral Posts** - High-engagement posts and threads
+3. **Hashtags** - Trending hashtags
+4. **Sentiment** - General sentiment around trends
+5. **Key Accounts** - Influential accounts driving trends
+
+## How It Works
+
+```
+User: /x-trends AI
+
+Skill:
+1. Search: "trending on X Twitter AI today"
+2. Search: "viral X posts AI 2026"
+3. Search: "X trending hashtags AI"
+4. Analyze: Extract patterns from web articles
+5. Report: Summarize trends with sources
+```
+
+## Sample Output
+
+```
+🔥 X Trends: AI (Last 24 hours)
+
+Top Topics:
+1. #ClaudeCode - 45K mentions
+   - New features announced
+   - Sentiment: Positive
+   - Key accounts: @AnthropicAI
+
+2. DeepSeek R1 - 32K mentions
+   - Performance comparisons
+   - Sentiment: Mixed
+   - Key accounts: @DeepSeekAI
+
+3. AI Coding Agents - 28K mentions
+   - Developer productivity
+   - Sentiment: Positive
+   - Key accounts: @cursor_ai
+
+Viral Posts:
+- @mvanhorn: "Claude Code just changed how I build..." (12K likes)
+- @steipete: "Bird CLI free X search is a game changer" (8K likes)
+
+Trending Hashtags:
+#ClaudeCode #AI #Coding #DeepSeek #OpenAI
+```
+
+## Limitations
+
+1. **Not real-time** - Web search has some delay vs direct X API
+2. **No engagement metrics** - Cannot get exact like/retweet counts
+3. **Indirect access** - Relies on articles about X, not X directly
+4. **Coverage gaps** - Very recent trends may not be indexed yet
+
+## Comparison with Direct X Access
+
+| Feature | Direct X API | x-trends (web search) |
+|---------|--------------|----------------------|
+| **Real-time** | ✅ Yes | ⚠️ Slight delay |
+| **Engagement metrics** | ✅ Exact counts | ❌ Estimated only |
+| **Cost** | 💰 Expensive | ✅ Free |
+| **Setup** | Complex auth | ✅ Simple |
+| **Rate limits** | Strict | ✅ Generous |
+| **All posts** | ✅ Complete | ❌ Sample via articles |
+
+## When to Use
+
+**Use x-trends when:**
+- You need general trend awareness
+- You want trending topics overview
+- You don't need exact metrics
+- You want quick, free access
+
+**Use direct X API when:**
+- You need real-time monitoring
+- You require exact engagement data
+- You're doing research requiring all posts
+- You have budget for API access
+
+## Future Enhancements
+
+- [ ] Add sentiment analysis
+- [ ] Trend prediction based on velocity
+- [ ] Historical trend comparison
+- [ ] Category-specific trend tracking
+- [ ] Key influencer identification
+
+## Credits
+
+Created as part of the last30days-kimi skill set.
+Uses kimi_search for web-based X trend discovery.