clamper-ai 1.1.6 → 1.3.0

package/README.md

@@ -18,7 +18,7 @@
 ## 🚀 Quick Start
 
 ```bash
-npm install -g clamper
+npm install -g clamper-ai
 clamper init
 clamper status
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clamper-ai",
-  "version": "1.1.6",
+  "version": "1.3.0",
   "description": "Transform your OpenClaw agent into a production-ready AI assistant with memory, skills, and a dashboard",
   "type": "module",
   "bin": {
@@ -20,5 +20,9 @@
   "engines": {
     "node": ">=18"
   },
+  "files": [
+    "bin/",
+    "skills/"
+  ],
   "dependencies": {}
-}
+}

package/skills/4chan-reader/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: 4chan Reader
+description: Browse and summarize 4chan boards and threads with content filtering
+author: aiasisbot61
+version: 1.0.0
+tier: pro
+category: Social Media
+tags: [4chan, imageboard, threads, boards, anonymous, forum]
+triggers: [4chan, check 4chan, whats on 4chan, board thread, anon, greentext]
+api_auth: none
+---
+
+# 4chan Reader
+
+Browse 4chan boards and threads through a clean, filtered interface. Summarize thread discussions, track trending topics, and filter content. Uses the official 4chan read-only API.
+
+## API Details
+
+- **Base URL:** `https://a.4cdn.org`
+- **Auth:** None required
+- **Rate Limit:** 1 request per second
+- **Docs:** https://github.com/4chan/4chan-API
+- **Note:** Read-only API, no posting capability
+
+## Endpoints
+
+### Get Board List
+```
+GET https://a.4cdn.org/boards.json
+```
+
+### Get Thread List (Catalog)
+```
+GET https://a.4cdn.org/{board}/catalog.json
+```
+
+### Get Thread
+```
+GET https://a.4cdn.org/{board}/thread/{thread_no}.json
+```
+
+### Get Page
+```
+GET https://a.4cdn.org/{board}/{page}.json
+```
+
+## Popular Boards
+
+| Board | Code | Description |
+|-------|------|-------------|
+| Technology | /g/ | Software, hardware, programming |
+| Business | /biz/ | Finance, crypto, entrepreneurship |
+| Science | /sci/ | Science and math |
+| DIY | /diy/ | Do it yourself projects |
+| Fitness | /fit/ | Health and fitness |
+| Cooking | /ck/ | Food and cooking |
+| Auto | /o/ | Cars and vehicles |
+| Anime | /a/ | Anime and manga |
+| Video Games | /v/ | Video games discussion |
+| Music | /mu/ | Music discussion |
+| Literature | /lit/ | Books and writing |
+| Politics | /pol/ | Political discussion |
+
+## Usage Examples
+
+### Browse a board's catalog
+```bash
+curl -s "https://a.4cdn.org/g/catalog.json"
+```
+
+### Read a specific thread
+```bash
+curl -s "https://a.4cdn.org/g/thread/12345678.json"
+```
+
+### Get all boards
+```bash
+curl -s "https://a.4cdn.org/boards.json"
+```
+
+## Content Filtering
+
+This skill includes built-in content filtering:
+- **Safe mode** (default): Filters NSFW boards and content
+- **SFW boards only**: Restricts to work-safe boards
+- **Keyword filtering**: Skip threads with specified keywords
+- **Summary mode**: AI summarizes threads instead of showing raw posts
+
+## Clamper Integration
+
+When the user asks about 4chan:
+1. Default to safe/SFW boards only
+2. Summarize threads rather than showing raw content
+3. Highlight interesting discussions and insights
+4. Apply content filtering automatically
+5. Respect the 1-request-per-second rate limit
+
+### Example Interaction
+```
+User: What's trending on /g/ right now?
+Assistant: *fetches /g/catalog.json*
+
+📋 Trending on /g/ - Technology:
+
+1. 🔥 "Linux kernel 6.18 released" (342 replies)
+   Summary: Discussion about new features, performance improvements,
+   and driver support. General consensus is positive.
+
+2. 💻 "Best budget mechanical keyboard 2026?" (128 replies)
+   Summary: Recommendations include Keychron V-series and Royal
+   Kludge boards. Heated debate about switches.
+
+3. 🤖 "Local LLM thread" (256 replies)
+   Summary: Comparing Llama 4 vs Mistral models for local
+   inference. Performance benchmarks shared.
+
+4. 📱 "Pixel 11 vs iPhone 18" (89 replies)
+   Summary: Camera comparison thread with sample photos.
+
+5. 🐧 "Daily driver distro thread" (201 replies)
+   Summary: Arch vs Fedora vs NixOS debate continues.
+```
+
+### Thread deep-dive
+```
+User: Summarize that Linux kernel thread
+Assistant: *fetches thread details*
+
+📖 Thread Summary: Linux Kernel 6.18
+
+Key points discussed:
+• New Rust driver support expanded to network subsystem
+• 15% improvement in io_uring performance
+• Controversial: removal of legacy x86 support
+• AMD GPU driver improvements praised
+• Several users report boot issues on specific hardware
+
+Sentiment: Mostly positive (72%), some concerns about legacy support
+Most mentioned: Rust, performance, AMD, io_uring
+```

package/skills/adhd-assistant/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: ADHD Assistant
+description: Productivity assistant designed for ADHD minds - task breakdown, focus timers, and gentle accountability
+author: thinktankmachine
+version: 1.0.0
+tier: pro
+category: Productivity
+tags: [adhd, productivity, focus, task-management, pomodoro, accountability]
+triggers: [adhd help, focus, can't concentrate, task breakdown, overwhelmed, brain dump, body doubling]
+api_auth: none
+---
+
+# ADHD Assistant
+
+A productivity assistant specifically designed for ADHD brains. Helps with task initiation, breaking down overwhelming projects, maintaining focus, and providing gentle accountability without judgment.
+
+## Core Features
+
+### 1. Task Breakdown Engine
+Transforms overwhelming tasks into small, actionable steps that feel achievable.
+
+```
+User: I need to clean my entire apartment and I can't start
+Assistant:
+Let's make this tiny and doable. Pick ONE of these to start:
+
+🟢 EASY WINS (2 min each):
+  □ Throw away any visible trash in the room you're in right now
+  □ Put 3 things back where they belong
+  □ Wipe down one surface
+
+🟡 NEXT STEPS (5 min each):
+  □ Load/unload the dishwasher
+  □ Gather all dirty clothes into one pile
+  □ Clear off one counter/table
+
+You don't have to do them all. Just pick one. Which one feels easiest right now?
+```
+
+### 2. Focus Mode (Pomodoro Variant)
+ADHD-friendly work sessions with flexible timing.
+
+```
+User: Help me focus on writing my report
+Assistant:
+🍅 ADHD Focus Session - Writing Report
+
+Let's do a SHORT sprint. You can always do another one.
+
+⏱️ Work: 15 minutes (shorter than standard Pomodoro - that's OK!)
+☕ Break: 5 minutes
+🎯 Micro-goal: Write just the introduction paragraph
+
+Starting now. I'll check in at the halfway mark.
+
+TIP: Put your phone in another room or face-down.
+```
+
+### 3. Brain Dump Processor
+Capture chaotic thoughts and organize them into actionable items.
+
+```
+User: Brain dump: need to email boss, dog vet appointment, buy groceries, project deadline friday, call mom, fix website bug, dentist, taxes
+Assistant:
+📝 Brain Dump Organized!
+
+🔴 URGENT (Do today):
+  □ Email boss
+  □ Fix website bug (deadline Friday)
+
+🟡 THIS WEEK:
+  □ Project deadline - Friday
+  □ Call mom
+  □ Buy groceries
+
+📅 SCHEDULE THESE:
+  □ Dog vet appointment → When was the last visit?
+  □ Dentist → When's a good day?
+
+📋 CAN WAIT:
+  □ Taxes → When are they due?
+
+Start with: Email your boss. It'll take 5 minutes and you'll feel relief.
+```
+
+### 4. Gentle Accountability
+Check-ins without shame or judgment.
+
+```
+Assistant: Hey! You mentioned you were going to email your boss. How's that going?
+
+Options:
+a) ✅ Done! (Amazing!)
+b) 🔄 Working on it (Great, keep going!)
+c) 😅 Haven't started yet (No judgment - let's figure out the blocker)
+d) 🔀 Priorities changed (Totally valid, let's replan)
+```
+
+### 5. Transition Support
+Help moving between tasks (a common ADHD struggle).
+
+```
+User: I finished the email but now I can't switch to coding
+Assistant:
+Transition time! Here's a quick bridge:
+
+1. ✅ Close your email tab (physically do it now)
+2. 🧍 Stand up and stretch for 30 seconds
+3. 💧 Get a glass of water
+4. 💻 Open your code editor (just open it, don't code yet)
+5. 📝 Write ONE comment about what you need to do first
+
+That's it. The hardest part is opening the file. You got this.
+```
+
+## ADHD-Specific Strategies
+
+| Strategy | When to Use | How It Helps |
+|----------|------------|--------------|
+| **2-Minute Rule** | Task feels too big | If it takes < 2 min, do it now |
+| **Body Doubling** | Can't start alone | AI works "alongside" you |
+| **External Timer** | Time blindness | Visible countdown + check-ins |
+| **Task Batching** | Context switching issues | Group similar tasks together |
+| **Reward Linking** | No motivation | Pair boring task with enjoyable one |
+| **Decision Reduction** | Decision fatigue | AI picks the next task for you |
+
+## Usage Modes
+
+### Quick Mode
+```
+User: Pick something for me to do
+Assistant: Based on what you told me earlier:
+→ Email your boss about the Friday deadline (5 minutes, high impact)
+Just hit reply and write 2-3 sentences. Go!
+```
+
+### Planning Mode
+```
+User: Help me plan my week
+Assistant: Let's keep this simple - no elaborate systems.
+
+Monday Focus: [1 big thing]
+Tuesday Focus: [1 big thing]
+...
+Daily non-negotiables: [2-3 tiny habits]
+Permission to skip: Everything else
+```
+
+### Crisis Mode
+```
+User: Everything is due and I'm panicking
+Assistant: OK. Stop. Breathe.
+
+Here's what we're doing RIGHT NOW:
+1. Nothing is on fire (even if it feels like it)
+2. List everything that's "due" - I'll help prioritize
+3. We'll pick THE ONE thing that matters most
+4. You'll work on just that for 25 minutes
+
+What's due? Let's get it out of your head.
+```
+
+## Clamper Integration
+
+When the user shows signs of ADHD-related challenges:
+1. Use encouraging, non-judgmental language
+2. Break everything into the smallest possible steps
+3. Offer choices instead of long lists
+4. Check in periodically but respect their autonomy
+5. Celebrate small wins genuinely
+6. Never say "just do it" or "it's easy"

package/skills/agenthire/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: AgentHire
+description: AI agent recruitment platform - find, evaluate, and deploy specialized AI agents
+author: lngdao
+version: 1.0.0
+tier: pro
+category: AI Services
+tags: [ai-agents, automation, hiring, multi-agent, orchestration]
+triggers: [hire agent, ai agent, find agent, deploy agent, agent marketplace]
+api_auth: none
+---
+
+# AgentHire
+
+Find and deploy specialized AI agents for specific tasks. AgentHire acts as a recruitment platform for AI agents, matching your task requirements with the best available agent.
+
+## Overview
+
+Instead of one general-purpose AI, AgentHire connects you with specialized agents optimized for specific domains:
+
+- **Research Agent** - Deep web research, academic papers, data gathering
+- **Code Agent** - Code generation, debugging, refactoring, code review
+- **Writing Agent** - Content creation, copywriting, editing, translation
+- **Data Agent** - Data analysis, visualization, statistical modeling
+- **Design Agent** - UI/UX suggestions, layout critique, design systems
+- **Marketing Agent** - Campaign planning, SEO, social media strategy
+- **Finance Agent** - Financial analysis, budgeting, forecasting
+- **Legal Agent** - Contract review, compliance checking, legal research
+
+## How It Works
+
+1. **Describe Your Task** - Explain what you need accomplished
+2. **Agent Matching** - AgentHire evaluates which specialized agent is best suited
+3. **Agent Deployment** - The matched agent is deployed with task-specific context
+4. **Result Delivery** - Receive structured output from the specialized agent
+
+## Agent Profiles
+
+### Research Agent
+```
+Specialties: Web research, literature review, competitive analysis
+Input: Research question or topic
+Output: Structured report with sources
+Best for: Market research, fact-checking, academic reviews
+```
+
+### Code Agent
+```
+Specialties: Python, JavaScript, TypeScript, Rust, Go
+Input: Code task description or existing code
+Output: Working code with tests and documentation
+Best for: Feature development, bug fixes, code review
+```
+
+### Writing Agent
+```
+Specialties: Blog posts, marketing copy, technical docs, creative writing
+Input: Topic, tone, audience, length requirements
+Output: Polished content ready for publishing
+Best for: Content marketing, documentation, newsletters
+```
+
+### Data Agent
+```
+Specialties: SQL, Python/Pandas, data visualization, ML models
+Input: Dataset + analysis question
+Output: Analysis report with charts and insights
+Best for: Business intelligence, reporting, predictive analytics
+```
+
+## Usage Examples
+
+### Hire a research agent
+```
+User: I need an agent to research the current state of electric vehicle batteries
+Assistant: Deploying Research Agent for your task...
+
+🤖 Research Agent Deployed
+Task: EV Battery Technology Research
+Scope: Current state, key players, recent breakthroughs, market trends
+
+The Research Agent will compile:
+1. Technology overview (solid-state, lithium-ion, sodium-ion)
+2. Key companies and their progress
+3. Recent breakthroughs (last 6 months)
+4. Market projections
+5. Sources and references
+```
+
+### Hire a code review agent
+```
+User: I need someone to review my Python API code for security issues
+Assistant: Deploying Code Agent (Security Focus)...
+
+🤖 Code Agent Deployed
+Mode: Security Audit
+Language: Python
+Focus areas: Input validation, authentication, SQL injection, XSS, dependency vulnerabilities
+```
+
+## Multi-Agent Workflows
+
+AgentHire supports chaining agents for complex tasks:
+
+```
+User: Research competitors, then write a blog post about our advantages
+Assistant:
+Step 1: Research Agent → Competitive analysis report
+Step 2: Writing Agent → Blog post using research findings
+
+Deploying pipeline: Research Agent → Writing Agent
+Estimated completion: 10 minutes
+```
+
+## Clamper Integration
+
+When the user describes a complex task:
+1. Analyze the task requirements and domain
+2. Recommend the best agent (or agent pipeline)
+3. Deploy with task-specific configuration
+4. Monitor progress and deliver results
+5. Allow user to provide feedback for agent improvement

package/skills/ai-daily-briefing/SKILL.md

@@ -0,0 +1,162 @@
+---
+name: AI Daily Briefing
+description: Personalized daily news and task briefing - weather, calendar, news, and priorities
+author: jeffjhunter
+version: 1.0.0
+tier: pro
+category: Productivity
+tags: [daily-briefing, news, productivity, morning-routine, summary, digest]
+triggers: [daily briefing, morning briefing, what's happening today, daily digest, news summary, today's agenda]
+api_auth: optional
+---
+
+# AI Daily Briefing
+
+Get a personalized morning briefing combining weather, top news, your calendar events, task priorities, and market data. Configurable sections and delivery time.
+
+## Briefing Sections
+
+### 1. Weather Forecast
+```
+🌤️ Weather for San Francisco, CA
+Today: 68°F / Partly Cloudy
+High: 72°F | Low: 58°F
+Wind: 12 mph W | Humidity: 65%
+Tomorrow: 70°F / Sunny
+```
+
+### 2. Top News Headlines
+```
+📰 Top Stories
+1. [Tech] OpenAI announces GPT-5 with breakthrough reasoning
+2. [Business] Fed holds interest rates steady at 4.5%
+3. [Science] NASA confirms water ice discovery on Mars
+4. [World] EU passes landmark AI regulation framework
+5. [Sports] Warriors clinch playoff berth with comeback win
+```
+
+### 3. Calendar Overview
+```
+📅 Today's Schedule
+09:00 - Team standup (Zoom)
+11:00 - Client call with Acme Corp
+12:30 - Lunch with Sarah
+14:00 - Sprint planning
+16:00 - Dentist appointment
+```
+
+### 4. Task Priorities
+```
+✅ Priority Tasks
+🔴 Submit Q1 report (due today)
+🔴 Review PR #234 (blocking release)
+🟡 Update documentation
+🟡 Reply to vendor email
+🟢 Research new CI/CD tools
+```
+
+### 5. Market Summary (Optional)
+```
+📈 Markets
+S&P 500: 5,234.18 (+0.8%)
+NASDAQ: 16,428.82 (+1.2%)
+BTC: $67,432 (+2.1%)
+ETH: $3,891 (-0.3%)
+```
+
+## Configuration
+
+### Briefing Config
+```json
+{
+  "location": "San Francisco, CA",
+  "sections": ["weather", "news", "calendar", "tasks", "markets"],
+  "news_categories": ["tech", "business", "science"],
+  "news_count": 5,
+  "calendar_source": "google",
+  "market_symbols": ["SPY", "QQQ", "BTC-USD"],
+  "delivery_time": "07:00",
+  "timezone": "America/Los_Angeles"
+}
+```
+
+### Data Sources
+
+| Section | Source | Auth Required |
+|---------|--------|--------------|
+| Weather | OpenWeatherMap API | API key (free tier) |
+| News | NewsAPI, GNews, or RSS feeds | API key (free tier) |
+| Calendar | Google Calendar API | OAuth |
+| Tasks | Todoist, Notion, or local | Varies |
+| Markets | Yahoo Finance API | None |
+
+## Setup
+
+### Environment Variables
+```bash
+export BRIEFING_LOCATION="San Francisco, CA"
+export OPENWEATHER_API_KEY="your_key"
+export NEWS_API_KEY="your_key"
+export GOOGLE_CALENDAR_ID="primary"
+```
+
+## Usage Examples
+
+### Full morning briefing
+```
+User: Give me my morning briefing
+Assistant:
+
+☀️ Good morning! Here's your briefing for Monday, March 1, 2026:
+
+🌤️ WEATHER — San Francisco
+Currently 62°F, partly cloudy. High of 71°F today.
+No rain expected. Great day to go outside!
+
+📰 TOP NEWS
+1. SpaceX Starship completes first orbital refueling test
+2. Apple announces M5 chip with 3nm architecture
+3. Senate passes bipartisan infrastructure bill
+...
+
+📅 YOUR DAY
+• 09:00 - Team standup
+• 11:00 - Client call (prep the demo!)
+• 14:00 - Sprint planning
+
+✅ TOP PRIORITIES
+🔴 Q1 report due TODAY
+🟡 3 unread Slack messages from your manager
+
+Have a productive day! ☕
+```
+
+### Custom briefing
+```
+User: Just give me weather and news, skip the rest
+Assistant: *delivers only weather and news sections*
+```
+
+### Evening recap
+```
+User: How did today go?
+Assistant:
+
+📊 Today's Recap — March 1, 2026
+
+✅ Completed: 4/6 tasks
+📅 Attended: 3/3 meetings
+📧 Emails: 12 sent, 34 received
+⏱️ Focus time: ~3.5 hours
+
+Tomorrow's first priority: Finish Q1 report (carried over)
+```
+
+## Clamper Integration
+
+When the user asks for a briefing:
+1. Check configured sections and data sources
+2. Fetch data from each source in parallel
+3. Format into a clean, scannable briefing
+4. Highlight urgent items (overdue tasks, severe weather, breaking news)
+5. Keep it concise - the briefing should take < 2 minutes to read