@musashishao/agent-kit 1.1.4 → 1.1.6

package/.agent/skills/context-engineering/scripts/skill_checker.py

@@ -0,0 +1,194 @@
+#!/usr/bin/env python3
+"""
+Skill Quality Checker
+Analyzes skills for quality and completeness.
+
+Usage:
+    python skill_checker.py [skill_name]
+    python skill_checker.py --all
+    
+Example:
+    python skill_checker.py react-patterns
+    python skill_checker.py --all
+"""
+
+import os
+import sys
+import re
+from pathlib import Path
+from typing import Dict, List, Optional
+
+# ANSI colors
+class Colors:
+    RED = '\033[91m'
+    GREEN = '\033[92m'
+    YELLOW = '\033[93m'
+    BLUE = '\033[94m'
+    MAGENTA = '\033[95m'
+    CYAN = '\033[96m'
+    RESET = '\033[0m'
+    BOLD = '\033[1m'
+
+
+class SkillChecker:
+    """Check skill quality and completeness"""
+    
+    REQUIRED_FRONTMATTER = ["name", "description"]
+    RECOMMENDED_FRONTMATTER = ["requirements", "types"]
+    RECOMMENDED_SECTIONS = ["Core Philosophy", "How to Apply", "References"]
+    
+    def __init__(self, skills_dir: Path):
+        self.skills_dir = skills_dir
+        
+    def check_skill(self, skill_name: str) -> Dict:
+        """Check a single skill"""
+        skill_path = self.skills_dir / skill_name
+        skill_md = skill_path / "SKILL.md"
+        
+        if not skill_path.exists():
+            return {"name": skill_name, "exists": False, "score": 0}
+        
+        result = {
+            "name": skill_name,
+            "exists": True,
+            "checks": [],
+            "score": 0
+        }
+        
+        if not skill_md.exists():
+            result["checks"].append(("SKILL.md", False, "Missing"))
+            return result
+        
+        content = skill_md.read_text()
+        
+        # Check frontmatter
+        frontmatter_match = re.match(r"^---\n(.+?)\n---", content, re.DOTALL)
+        if frontmatter_match:
+            frontmatter = frontmatter_match.group(1)
+            
+            for field in self.REQUIRED_FRONTMATTER:
+                has_field = bool(re.search(rf"^{field}:\s*.+", frontmatter, re.MULTILINE))
+                result["checks"].append((f"Frontmatter: {field}", has_field, "Found" if has_field else "Missing (required)"))
+            
+            for field in self.RECOMMENDED_FRONTMATTER:
+                has_field = bool(re.search(rf"^{field}:\s*.+", frontmatter, re.MULTILINE))
+                if has_field:
+                    result["checks"].append((f"Frontmatter: {field}", True, "Found"))
+        else:
+            result["checks"].append(("Frontmatter", False, "Missing YAML frontmatter"))
+        
+        # Check content quality
+        word_count = len(content.split())
+        has_enough_content = word_count > 100
+        result["checks"].append(("Content length", has_enough_content, f"{word_count} words" if has_enough_content else "Too short"))
+        
+        # Check for code examples
+        has_code = "```" in content
+        result["checks"].append(("Code examples", has_code, "Found" if has_code else "Consider adding"))
+        
+        # Check for recommended sections
+        for section in self.RECOMMENDED_SECTIONS:
+            has_section = section.lower() in content.lower()
+            if has_section:
+                result["checks"].append((f"Section: {section}", True, "Found"))
+        
+        # Check for additional files
+        additional_files = list(skill_path.glob("**/*"))
+        has_scripts = any("script" in str(f).lower() for f in additional_files)
+        has_examples = any("example" in str(f).lower() for f in additional_files)
+        
+        if has_scripts:
+            result["checks"].append(("Scripts", True, "Has automation scripts"))
+        if has_examples:
+            result["checks"].append(("Examples", True, "Has examples"))
+        
+        # Calculate score
+        passed = sum(1 for _, p, _ in result["checks"] if p)
+        total = len(result["checks"])
+        result["score"] = (passed / total * 100) if total > 0 else 0
+        
+        return result
+    
+    def check_all(self) -> List[Dict]:
+        """Check all skills"""
+        results = []
+        
+        for skill_dir in sorted(self.skills_dir.iterdir()):
+            if skill_dir.is_dir():
+                result = self.check_skill(skill_dir.name)
+                results.append(result)
+        
+        return results
+    
+    def print_result(self, result: Dict):
+        """Print result for a single skill"""
+        name = result["name"]
+        score = result.get("score", 0)
+        
+        color = Colors.GREEN if score >= 80 else Colors.YELLOW if score >= 60 else Colors.RED
+        status = "✓" if score >= 80 else "⚠" if score >= 60 else "✗"
+        
+        print(f"\n{Colors.BOLD}{Colors.CYAN}{name}{Colors.RESET} {color}[{score:.0f}%]{Colors.RESET}")
+        
+        for check_name, passed, message in result.get("checks", []):
+            status_icon = f"{Colors.GREEN}✓{Colors.RESET}" if passed else f"{Colors.YELLOW}○{Colors.RESET}"
+            print(f"  {status_icon} {check_name}: {message}")
+    
+    def print_summary(self, results: List[Dict]):
+        """Print summary of all skills"""
+        print(f"\n{Colors.BOLD}{Colors.MAGENTA}📊 Skills Quality Summary{Colors.RESET}\n")
+        
+        excellent = sum(1 for r in results if r.get("score", 0) >= 80)
+        good = sum(1 for r in results if 60 <= r.get("score", 0) < 80)
+        needs_work = sum(1 for r in results if r.get("score", 0) < 60)
+        
+        print(f"  {Colors.GREEN}Excellent (80%+): {excellent}{Colors.RESET}")
+        print(f"  {Colors.YELLOW}Good (60-79%): {good}{Colors.RESET}")
+        print(f"  {Colors.RED}Needs work (<60%): {needs_work}{Colors.RESET}")
+        print(f"\n  Total: {len(results)} skills")
+        
+        avg_score = sum(r.get("score", 0) for r in results) / len(results) if results else 0
+        color = Colors.GREEN if avg_score >= 80 else Colors.YELLOW if avg_score >= 60 else Colors.RED
+        print(f"  {color}Average Quality Score: {avg_score:.1f}%{Colors.RESET}")
+
+
+def main():
+    # Find skills directory
+    cwd = Path.cwd()
+    skills_dir = cwd / ".agent" / "skills"
+    
+    if not skills_dir.exists():
+        print(f"{Colors.RED}Error: .agent/skills not found{Colors.RESET}")
+        sys.exit(1)
+    
+    checker = SkillChecker(skills_dir)
+    
+    if len(sys.argv) > 1:
+        arg = sys.argv[1]
+        
+        if arg == "--all":
+            results = checker.check_all()
+            for result in results:
+                if result.get("score", 0) < 80:  # Only show non-excellent
+                    checker.print_result(result)
+            checker.print_summary(results)
+        else:
+            result = checker.check_skill(arg)
+            checker.print_result(result)
+    else:
+        # Default: show summary only
+        results = checker.check_all()
+        checker.print_summary(results)
+        
+        # Show top 5 needing improvement
+        needs_work = sorted([r for r in results if r.get("score", 0) < 80], 
+                           key=lambda x: x.get("score", 0))[:5]
+        
+        if needs_work:
+            print(f"\n{Colors.YELLOW}Skills needing improvement:{Colors.RESET}")
+            for r in needs_work:
+                print(f"  - {r['name']}: {r.get('score', 0):.0f}%")
+
+
+if __name__ == "__main__":
+    main()

package/.agent/templates/AGENTS.backend.md

@@ -0,0 +1,230 @@
+# AGENTS.md - Backend API
+
+> **[PROJECT_NAME]** - Production-ready backend API.
+
+---
+
+## 🚀 Project Overview
+
+[Brief description of your backend API]
+
+### Tech Stack
+
+| Layer | Technology | Version |
+|-------|------------|---------|
+| **Runtime** | Node.js | 20.x LTS |
+| **Framework** | Express / Fastify / NestJS | - |
+| **Language** | TypeScript | 5.x |
+| **Database** | PostgreSQL + Prisma | - |
+| **Cache** | Redis | 7.x |
+| **Auth** | JWT + bcrypt | - |
+| **Docs** | Swagger / OpenAPI | 3.1 |
+
+---
+
+## 🛠️ Setup Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Setup database
+npx prisma generate
+npx prisma migrate dev
+
+# Seed database
+npm run db:seed
+
+# Start development server
+npm run dev
+
+# Build for production
+npm run build
+
+# Start production server
+npm start
+
+# Run tests
+npm test
+
+# Lint code
+npm run lint
+```
+
+---
+
+## 📏 Code Style & Standards
+
+### TypeScript
+- Strict mode enabled
+- Proper typing for all functions
+- DTOs for request/response validation
+
+### API Patterns
+- RESTful conventions
+- Consistent error handling
+- Request validation with Zod/Joi
+- Response serialization
+
+### File Naming
+- Controllers: `resource.controller.ts`
+- Services: `resource.service.ts`
+- Routes: `resource.routes.ts`
+
+---
+
+## 📁 Project Structure
+
+```
+src/
+├── controllers/            # Request handlers
+├── services/              # Business logic
+├── routes/                # API routes
+├── middleware/
+│   ├── auth.ts           # Authentication
+│   ├── validation.ts     # Request validation
+│   └── error-handler.ts  # Error handling
+├── models/                # Database models
+├── types/                 # TypeScript types
+├── utils/                 # Utility functions
+├── config/                # Configuration
+└── index.ts               # Entry point
+```
+
+---
+
+## 🔌 API Endpoints
+
+```
+GET    /api/v1/resources          # List resources
+POST   /api/v1/resources          # Create resource
+GET    /api/v1/resources/:id      # Get single resource
+PUT    /api/v1/resources/:id      # Update resource
+DELETE /api/v1/resources/:id      # Delete resource
+```
+
+API Documentation: `http://localhost:3000/api/docs`
+
+---
+
+## 🔒 Security Guidelines
+
+### Environment Variables
+```bash
+# Required (never commit these)
+DATABASE_URL=
+JWT_SECRET=
+REDIS_URL=
+```
+
+### Best Practices
+- Input validation on all endpoints
+- Rate limiting on sensitive routes
+- CORS configuration
+- Helmet for security headers
+- SQL injection prevention (use Prisma/ORM)
+- Password hashing with bcrypt
+- JWT token expiration
+
+### Authentication Flow
+```
+POST /api/v1/auth/register
+POST /api/v1/auth/login
+POST /api/v1/auth/refresh
+POST /api/v1/auth/logout
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+# Unit tests
+npm test
+
+# Integration tests
+npm run test:integration
+
+# Coverage report
+npm run test:coverage
+```
+
+### Test Structure
+```
+__tests__/
+├── unit/
+│   ├── services/
+│   └── utils/
+├── integration/
+│   └── api/
+└── fixtures/
+```
+
+---
+
+## 📊 Database
+
+### Prisma Commands
+```bash
+# Generate client
+npx prisma generate
+
+# Create migration
+npx prisma migrate dev --name migration_name
+
+# Reset database
+npx prisma migrate reset
+
+# Open Prisma Studio
+npx prisma studio
+```
+
+---
+
+## 🚀 Deployment
+
+```bash
+# Build
+npm run build
+
+# Start production
+NODE_ENV=production npm start
+
+# With PM2
+pm2 start ecosystem.config.js
+
+# Docker
+docker-compose up -d
+```
+
+---
+
+## 🤖 AI Agent Configuration
+
+### Quick Commands
+
+| Command | Description |
+|---------|-------------|
+| `/create user CRUD` | Create CRUD endpoints |
+| `/debug 500 error` | Debug server errors |
+| `/test UserService` | Generate tests |
+| `/plan microservice` | Plan architecture |
+
+### Agent Mentions
+
+- `@backend-specialist` - API development
+- `@database-architect` - Schema design
+- `@security-auditor` - Security review
+- `@devops-engineer` - Deployment
+
+---
+
+## 📚 Additional Resources
+
+- [Express.js](https://expressjs.com)
+- [Prisma Documentation](https://www.prisma.io/docs)
+- [JWT Best Practices](https://jwt.io/introduction)
+
+---
+
+*Built with Agent Kit - AI-enhanced backend development*

package/.agent/templates/AGENTS.md

@@ -0,0 +1,121 @@
+# AGENTS.md
+
+> **Project using Agent Kit** - AI-enhanced development configuration.
+
+---
+
+## 🚀 Project Overview
+
+<!-- Replace with your project description -->
+[PROJECT_NAME] - [Brief description of what this project does]
+
+### Tech Stack
+<!-- Update based on your project -->
+| Layer | Technology |
+|-------|------------|
+| **Frontend** | Next.js / React |
+| **Backend** | Node.js / Express |
+| **Database** | PostgreSQL / MongoDB |
+| **Styling** | Tailwind CSS |
+
+---
+
+## 🛠️ Setup Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+
+# Run tests
+npm test
+
+# Build for production
+npm run build
+
+# Lint code
+npm run lint
+```
+
+---
+
+## 📏 Code Style
+
+- **TypeScript** strict mode enabled
+- **Functional components** with hooks
+- **Tailwind CSS** for styling
+- **Absolute imports** with `@/` alias
+- External links: always add `rel="noopener noreferrer"`
+
+---
+
+## 📁 Project Structure
+
+```
+src/
+├── app/              # Next.js App Router
+├── components/       # React components
+├── lib/              # Utilities
+├── hooks/            # Custom hooks
+└── types/            # TypeScript types
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+# Unit tests
+npm test
+
+# E2E tests  
+npm run test:e2e
+
+# Coverage report
+npm run test:coverage
+```
+
+---
+
+## 🔒 Security
+
+- No hardcoded API keys or secrets
+- Environment variables for configuration
+- Follow OWASP security guidelines
+- Input validation on all forms
+
+---
+
+## 🤖 AI Agent Configuration
+
+This project uses [Agent Kit](https://github.com/musashishao/agent-kit) for AI-enhanced development.
+
+### Available Slash Commands
+| Command | Purpose |
+|---------|---------|
+| `/create` | Create new features |
+| `/debug` | Debug issues |
+| `/test` | Generate tests |
+| `/deploy` | Deploy to production |
+| `/ui-ux-pro-max` | Design premium UI |
+
+### Available Agents
+Mention agents with `@agent-name`:
+- `@frontend-specialist` - UI development
+- `@backend-specialist` - API/server
+- `@debugger` - Bug fixing
+- `@security-auditor` - Security review
+
+---
+
+## 📚 Documentation
+
+- README.md - Getting started
+- docs/ - Detailed documentation
+- .agent/ - AI agent configuration
+
+---
+
+*Powered by Agent Kit*

package/.agent/templates/AGENTS.mobile.md

@@ -0,0 +1,183 @@
+# AGENTS.md - Mobile Application
+
+> **[PROJECT_NAME]** - Cross-platform mobile application.
+
+---
+
+## 🚀 Project Overview
+
+[Brief description of your mobile application]
+
+### Tech Stack
+
+| Layer | Technology | Version |
+|-------|------------|---------|
+| **Framework** | React Native | 0.76.x |
+| **Navigation** | React Navigation | 7.x |
+| **State** | Zustand / TanStack Query | - |
+| **Styling** | NativeWind (Tailwind) | 4.x |
+| **Build** | Expo | 52.x |
+| **Backend** | Firebase / Supabase | - |
+
+---
+
+## 🛠️ Setup Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Start Expo development server
+npm start
+
+# Run on iOS simulator
+npm run ios
+
+# Run on Android emulator
+npm run android
+
+# Run tests
+npm test
+
+# Lint code
+npm run lint
+```
+
+---
+
+## 📏 Code Style & Standards
+
+### TypeScript
+- Strict mode enabled
+- Proper typing for all props
+- No `any` types
+
+### React Native Patterns
+- Functional components with hooks
+- Memoization for performance
+- Platform-specific files when needed (`.ios.tsx`, `.android.tsx`)
+
+### File Naming
+- Screens: `ScreenName.tsx` → `HomeScreen.tsx`
+- Components: `ComponentName.tsx` → `Button.tsx`
+- Hooks: `useHookName.ts` → `useAuth.ts`
+
+---
+
+## 📁 Project Structure
+
+```
+src/
+├── app/                    # Expo Router screens
+│   ├── (tabs)/            # Tab navigation
+│   ├── (auth)/            # Auth screens
+│   └── _layout.tsx        # Root layout
+│
+├── components/
+│   ├── ui/                # Reusable UI components
+│   ├── forms/             # Form components
+│   └── layout/            # Layout components
+│
+├── lib/
+│   ├── api.ts             # API client
+│   └── utils.ts           # Utility functions
+│
+├── hooks/                  # Custom hooks
+├── stores/                 # Zustand stores
+├── types/                  # TypeScript types
+└── constants/             # App constants
+```
+
+---
+
+## 🔒 Security Guidelines
+
+### Environment Variables
+```bash
+# Use expo-constants or react-native-dotenv
+EXPO_PUBLIC_API_URL=
+EXPO_PUBLIC_FIREBASE_API_KEY=
+```
+
+### Best Practices
+- Never store sensitive data in AsyncStorage unencrypted
+- Use Keychain (iOS) / Keystore (Android) for tokens
+- Validate all API responses
+- Implement certificate pinning for production
+
+---
+
+## 🧪 Testing
+
+```bash
+# Unit tests with Jest
+npm test
+
+# E2E tests with Detox
+npm run test:e2e
+
+# Coverage report
+npm run test:coverage
+```
+
+---
+
+## 📱 Platform Specifics
+
+### iOS
+- Minimum iOS version: 15.1
+- Required permissions in `app.json`
+- Submit via App Store Connect
+
+### Android
+- Minimum SDK: 24 (Android 7.0)
+- Required permissions in `app.json`
+- Submit via Google Play Console
+
+---
+
+## 🚀 Deployment
+
+```bash
+# Build for iOS
+eas build --platform ios
+
+# Build for Android
+eas build --platform android
+
+# Submit to stores
+eas submit
+```
+
+---
+
+## 🤖 AI Agent Configuration
+
+### Quick Commands
+
+| Command | Description |
+|---------|-------------|
+| `/create login screen` | Create auth screens |
+| `/debug navigation crash` | Debug navigation issues |
+| `/test ProfileScreen` | Generate tests |
+| `/ui-ux-pro-max bottom sheet` | Design mobile UI |
+
+### Agent Mentions
+
+- `@mobile-developer` - React Native / Flutter
+- `@frontend-specialist` - Component design
+- `@backend-specialist` - API integration
+- `@test-engineer` - Test generation
+
+---
+
+## 📚 Additional Resources
+
+- [React Native Documentation](https://reactnative.dev)
+- [Expo Documentation](https://docs.expo.dev)
+- [React Navigation](https://reactnavigation.org)
+- [NativeWind](https://www.nativewind.dev)
+
+---
+
+*Built with Agent Kit - AI-enhanced mobile development*