@wipal/agent-team 1.0.3 → 1.1.0

package/.claude/commands/skills/discover.md

@@ -0,0 +1,127 @@
+# Discover Skills from skills.sh
+
+Search and discover skills from the skills.sh directory.
+
+## Usage
+
+```
+/discover <search-query> [options]
+```
+
+## Arguments
+
+- `<search-query>` - Keywords to search for (e.g., "react", "api design", "testing")
+
+## Options
+
+- `--role <role>` - Filter by agent role (dev-fe, dev-be, sa, devops, tech-lead, pm, qa)
+- `--category <cat>` - Filter by category (frontend, backend, architecture, devops, product, quality)
+- `--official` - Only show official sources (Anthropic, Vercel, Microsoft, etc.)
+- `--community` - Only show community sources
+- `--limit <n>` - Limit results (default: 10)
+
+## Examples
+
+```bash
+# Search for React skills
+/discover react
+
+# Search for frontend skills
+/discover frontend --category frontend
+
+# Search for dev-fe specific skills
+/discover components --role dev-fe
+
+# Search official sources only
+/discover testing --official
+
+# Search for backend API skills
+/discover api rest --category backend
+```
+
+## What This Command Does
+
+1. **Searches skills.sh** - Uses web search to query the skills.sh directory
+2. **Filters results** - Based on provided options (role, category, source type)
+3. **Presents findings** - Shows:
+   - Skill name and description
+   - Source (official/community)
+   - Install count
+   - Security status indicator
+
+## Output Format
+
+```
+🔍 Skills Discovery Results: "<search-query>"
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ OFFICIAL SOURCES (✅ Auto-validated)                                        │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ 1. react-best-practices                                                     │
+│    Source: vercel-labs/agent-skills                                        │
+│    Installs: 169K                                                          │
+│    Description: 40+ rules for React performance and best practices         │
+│                                                                             │
+│ 2. frontend-design                                                          │
+│    Source: anthropics/skills                                                │
+│    Installs: 100K                                                          │
+│    Description: Production-grade UI components with React/Tailwind         │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ COMMUNITY SOURCES (⚠️ Security review required)                            │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ 3. tailwind-design-system                                                   │
+│    Source: wshobson/agents                                                 │
+│    Installs: 11K                                                           │
+│    Description: Tailwind CSS design system patterns                        │
+│                                                                             │
+│ 4. vue-best-practices                                                       │
+│    Source: antfu/skills                                                    │
+│    Installs: 7K                                                            │
+│    Description: Vue.js best practices and patterns                         │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+📋 To install: /install-skill <owner/repo> --skill <skill-name>
+📋 Example: /install-skill vercel-labs/agent-skills --skill react-best-practices
+```
+
+## Search Tips
+
+### By Technology
+
+| Search Query | Expected Results |
+|--------------|------------------|
+| `react` | React patterns, hooks, best practices |
+| `vue` | Vue.js patterns, composition API |
+| `nestjs` | NestJS backend patterns |
+| `fastapi` | FastAPI Python patterns |
+| `tailwind` | Tailwind CSS patterns |
+| `docker` | Docker, containerization |
+| `kubernetes` | K8s patterns |
+
+### By Role
+
+| Role | Suggested Queries |
+|------|-------------------|
+| dev-fe | `react`, `vue`, `frontend`, `components`, `styling` |
+| dev-be | `api`, `database`, `nestjs`, `fastapi`, `prisma` |
+| sa | `architecture`, `microservices`, `design`, `patterns` |
+| devops | `docker`, `kubernetes`, `ci-cd`, `terraform` |
+| tech-lead | `code-review`, `mentoring`, `decision` |
+| pm | `requirements`, `user-stories`, `sprint` |
+| qa | `testing`, `e2e`, `playwright`, `cypress` |
+
+## How Search Works
+
+1. Uses web search with `site:skills.sh` filter
+2. Queries: `site:skills.sh <search-query> <category-filter>`
+3. Parses results for skill metadata
+4. Cross-references with skills-registry.yaml for installed status
+
+## Notes
+
+- Results may vary based on skills.sh availability
+- Install counts are from skills.sh leaderboard
+- Official sources are from recognized tech companies
+- Community sources require security validation before install

package/.claude/commands/skills/install.md

@@ -0,0 +1,225 @@
+# Install Skill from skills.sh
+
+Install a skill from skills.sh with automatic security validation.
+
+## Usage
+
+```
+/install-skill <owner/repo> [options]
+```
+
+## Arguments
+
+- `<owner/repo>` - GitHub repository (e.g., `vercel-labs/agent-skills`)
+
+## Options
+
+- `--skill <name>` - Specific skill from multi-skill repos
+- `--validate` - Run security validation (default: true)
+- `--no-validate` - Skip validation (not recommended)
+- `--dry-run` - Download and validate without installing
+- `--customize` - Open for customization after install
+
+## Examples
+
+```bash
+# Install specific skill from multi-skill repo
+/install-skill vercel-labs/agent-skills --skill react-best-practices
+
+# Install from official source
+/install-skill anthropics/skills --skill pdf
+
+# Dry run to check before installing
+/install-skill community/skill --dry-run
+
+# Install with customization
+/install-skill vercel-labs/agent-skills --skill frontend-design --customize
+```
+
+## Installation Workflow
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                         SKILL INSTALLATION WORKFLOW                          │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  1. FETCH                                                                    │
+│     ├── npx skills add <owner/repo> --dry-run                               │
+│     └── Download to ~/.skills/                                              │
+│                                                                              │
+│  2. VALIDATE (unless --no-validate)                                         │
+│     ├── Check source type (official/community)                              │
+│     ├── Run security-validator skill                                        │
+│     └── Generate security report                                            │
+│                                                                              │
+│  3. REPORT FINDINGS                                                          │
+│     ├── Official: Auto-approve with logging                                 │
+│     ├── Community: Present issues for user review                           │
+│     └── If issues: Wait for user decision                                   │
+│                                                                              │
+│  4. INSTALL                                                                  │
+│     ├── Determine target directory:                                         │
+│     │   ├── Official → .claude/skills/domain/<category>/                    │
+│     │   └── Community → .claude/skills/community/                           │
+│     ├── Copy skill files                                                    │
+│     └── Preserve structure (SKILL.md, references/)                          │
+│                                                                              │
+│  5. REGISTER                                                                 │
+│     ├── Add to skills-registry.yaml                                         │
+│     ├── Save security report to security-reports/                           │
+│     └── Update SKILL-INDEX.md if needed                                     │
+│                                                                              │
+│  6. CUSTOMIZE (if --customize)                                              │
+│     ├── Open SKILL.md for editing                                           │
+│     └── Adjust for project needs                                            │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+## Source Type Detection
+
+| Source | Installation Path | Validation |
+|--------|-------------------|------------|
+| Official (anthropics, vercel-labs, etc.) | `.claude/skills/domain/<category>/` | Auto-approve |
+| Community | `.claude/skills/community/` | Review required |
+| Local existing | Skip (already installed) | N/A |
+
+## Security Validation
+
+### Official Sources (Auto-approve)
+
+```
+✅ Source: vercel-labs (Official)
+✅ Security: Auto-validated
+✅ Installing to: .claude/skills/domain/frontend/react-best-practices/
+
+[Proceeding with installation...]
+```
+
+### Community Sources (Review Required)
+
+```
+⚠️ Source: community-dev (Community)
+⚠️ Security review required
+
+Running security validation...
+
+📋 Security Report:
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ Check          │ Status │ Issues                                          │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ Code Review    │ PASS   │ 0                                               │
+│ Command Scan   │ WARN   │ 1 (eval() on line 42)                          │
+│ URL Check      │ PASS   │ 0                                               │
+│ Dependency     │ PASS   │ 0                                               │
+│ Data Exfil     │ PASS   │ 0                                               │
+│ File Access    │ PASS   │ 0                                               │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+🟡 1 MEDIUM issue found:
+   - eval() usage at SKILL.md:42
+   - Recommendation: Use JSON.parse() instead
+
+Decision required:
+[1] APPROVE - Install anyway (acknowledge risk)
+[2] APPROVE WITH FIX - Fix issue then install
+[3] REJECT - Do not install
+
+Your choice: _
+```
+
+## Output
+
+### Successful Installation
+
+```
+✅ Skill Installed Successfully
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ Skill:           react-best-practices                                       │
+│ Source:          vercel-labs/agent-skills                                   │
+│ Installed to:    .claude/skills/domain/frontend/react-best-practices/      │
+│ Security:        ✅ Passed (Official source)                               │
+│ Registered:      skills-registry.yaml                                       │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+Files:
+├── SKILL.md
+└── references/
+    └── performance-rules.md
+
+Next steps:
+- Review skill content: cat .claude/skills/domain/frontend/react-best-practices/SKILL.md
+- Use in agent creation: /agent-creation
+- Link to existing agent: ln -s ../../skills/domain/frontend/react-best-practices .claude/agents/<agent>/skills/
+```
+
+### Dry Run Output
+
+```
+🔍 Dry Run: Skill Analysis
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ Skill:           example-skill                                              │
+│ Source:          community/example-repo                                     │
+│ Would install to: .claude/skills/community/example-skill/                  │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+Security Analysis:
+├── Code Review: PASS
+├── Command Scan: PASS
+├── URL Check: WARN (1 unknown domain)
+├── Dependency: PASS
+├── Data Exfil: PASS
+└── File Access: PASS
+
+⚠️ Would require user approval before installation.
+
+Run without --dry-run to install.
+```
+
+## Common Issues
+
+### Skill Already Installed
+
+```
+⚠️ Skill already installed: react-best-practices
+   Location: .claude/skills/domain/frontend/react-best-practices/
+
+Options:
+--force    Reinstall and overwrite
+--update   Update to latest version
+```
+
+### Skill Not Found
+
+```
+❌ Skill not found: <owner/repo>
+
+Suggestions:
+- Check the repository exists on GitHub
+- Verify the skill name with --skill option
+- Search first: /discover <keyword>
+```
+
+### Validation Failed (Critical)
+
+```
+🔴 Critical security issues found!
+
+Issues:
+1. CRITICAL: Malicious code pattern detected
+2. CRITICAL: External IP URL found
+
+Recommendation: DO NOT INSTALL
+
+This skill appears unsafe. If you still want to proceed,
+use --no-validate at your own risk.
+```
+
+## Integration
+
+- **After discovery**: Use `/discover <keyword>` first to find skills
+- **Before agent creation**: Skills are installed during `/agent-creation`
+- **For updates**: Re-run with same command to update
+- **Security reports**: Saved to `.claude/skills/security-reports/<skill-name>.md`

package/.claude/commands/skills/review.md

@@ -0,0 +1,234 @@
+# Review Existing Skills
+
+Review existing skills and find better alternatives from skills.sh.
+
+## Usage
+
+```
+/review-skills [options]
+```
+
+## Options
+
+- `--all` - Review all 37 existing skills
+- `--category <name>` - Review specific category (frontend, backend, architecture, devops, product, quality, leadership)
+- `--skill <name>` - Review specific skill
+- `--suggest` - Suggest better alternatives from skills.sh
+- `--report` - Generate detailed report file
+
+## Examples
+
+```bash
+# Review all skills
+/review-skills --all
+
+# Review frontend skills only
+/review-skills --category frontend
+
+# Review specific skill
+/review-skills --skill code-review
+
+# Review and suggest alternatives
+/review-skills --category frontend --suggest
+
+# Generate report file
+/review-skills --all --report
+```
+
+## Review Workflow
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                       SKILL REVIEW WORKFLOW                                  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  1. LIST EXISTING SKILLS                                                     │
+│     ├── Read skills-registry.yaml                                           │
+│     └── Filter by category if specified                                     │
+│                                                                              │
+│  2. FOR EACH SKILL                                                           │
+│     ├── Search skills.sh for similar skills                                 │
+│     ├── Compare:                                                            │
+│     │   ├── Content depth                                                   │
+│     │   ├── Examples quality                                                │
+│     │   ├── Last update                                                     │
+│     │   ├── Install count (if from skills.sh)                               │
+│     │   └── Source authority                                                │
+│     └── Calculate recommendation                                            │
+│                                                                              │
+│  3. GENERATE RECOMMENDATIONS                                                 │
+│     ├── KEEP: Current skill is good enough                                  │
+│     ├── UPDATE: Merge improvements from skills.sh                           │
+│     ├── REPLACE: Better alternative exists on skills.sh                     │
+│     └── NEW: Missing skill, should add                                      │
+│                                                                              │
+│  4. PRESENT REPORT                                                           │
+│     ├── Summary statistics                                                  │
+│     ├── Detailed recommendations                                            │
+│     └── Action items                                                        │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+## Comparison Criteria
+
+| Criterion | Weight | Description |
+|-----------|--------|-------------|
+| Content Depth | 30% | How comprehensive is the skill? |
+| Examples | 20% | Quality and quantity of code examples |
+| Maintenance | 20% | Last update, activity |
+| Authority | 15% | Official vs community source |
+| Install Count | 15% | Popularity on skills.sh |
+
+## Output Format
+
+### Summary Report
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                         SKILLS REVIEW REPORT                                  ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║ Date: 2025-02-26                                                             ║
+║ Skills Reviewed: 37                                                          ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║                                                                               ║
+║  RECOMMENDATIONS SUMMARY                                                      ║
+║  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━   ║
+║                                                                               ║
+║  ✅ KEEP:     25 skills (68%)                                                ║
+║  📝 UPDATE:   8 skills (22%)                                                 ║
+║  🔄 REPLACE:  2 skills (5%)                                                  ║
+║  ➕ NEW:      5 skills recommended                                           ║
+║                                                                               ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+### Detailed Recommendations
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ ✅ KEEP (25 skills)                                                          │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ These skills are well-written and project-specific:                         │
+│                                                                              │
+│ • code-review - Custom to project workflow, better than generic             │
+│ • git-automation - Integrated with project hooks                            │
+│ • system-design - Comprehensive with local examples                         │
+│ • adr-writing - Matches project ADR template                                │
+│ ... (21 more)                                                               │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ 📝 UPDATE (8 skills)                                                         │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ Can be improved with patterns from skills.sh:                               │
+│                                                                              │
+│ 1. frontend-design                                                           │
+│    Current: Basic React patterns                                            │
+│    Improvement: Add performance rules from vercel-labs/react-best-practices │
+│    Action: Merge 40+ rules from official source                             │
+│                                                                              │
+│ 2. api-design                                                                │
+│    Current: REST basics                                                      │
+│    Improvement: Add OpenAPI examples from anthropics/api-patterns           │
+│    Action: Add reference files with OpenAPI templates                       │
+│ ... (6 more)                                                                │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ 🔄 REPLACE (2 skills)                                                        │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ Better alternatives exist on skills.sh:                                      │
+│                                                                              │
+│ 1. testing-fe → vitest (antfu/skills)                                       │
+│    Reason: More comprehensive, 6K+ installs, actively maintained            │
+│    Migration: Low effort (similar structure)                                │
+│                                                                              │
+│ 2. performance-fe → react-performance (vercel-labs)                         │
+│    Reason: Official source, 58K installs, React-specific                    │
+│    Migration: Medium effort (need to adapt examples)                        │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ ➕ NEW RECOMMENDED (5 skills)                                                │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ Missing skills that should be added:                                         │
+│                                                                              │
+│ 1. error-handling (obra/superpowers)                                        │
+│    Reason: Better error patterns, defense-in-depth                          │
+│    Category: core                                                            │
+│                                                                              │
+│ 2. mcp-builder (anthropics/skills)                                          │
+│    Reason: MCP server creation capability                                   │
+│    Category: domain/backend                                                  │
+│                                                                              │
+│ 3. react-native (callstackincubator/agent-skills)                           │
+│    Reason: Mobile development support                                        │
+│    Category: domain/frontend                                                 │
+│                                                                              │
+│ 4. seo-audit (coreyhaines31/marketingskills)                                │
+│    Reason: SEO optimization for web projects                                 │
+│    Category: domain/product                                                  │
+│                                                                              │
+│ 5. debugging (obra/superpowers)                                             │
+│    Reason: Systematic debugging methodology                                  │
+│    Category: core                                                            │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Action Items
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ 📋 ACTION ITEMS                                                              │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│ Priority 1 (Immediate):                                                      │
+│ ├── [ ] Install mcp-builder from anthropics/skills                          │
+│ └── [ ] Merge react-best-practices into frontend-design                     │
+│                                                                              │
+│ Priority 2 (This Sprint):                                                    │
+│ ├── [ ] Replace testing-fe with vitest from antfu/skills                    │
+│ ├── [ ] Add error-handling from obra/superpowers                            │
+│ └── [ ] Update api-design with OpenAPI patterns                             │
+│                                                                              │
+│ Priority 3 (Next Sprint):                                                    │
+│ ├── [ ] Install react-native skills for mobile support                      │
+│ ├── [ ] Add seo-audit for web optimization                                  │
+│ └── [ ] Review and install debugging skill                                  │
+│                                                                              │
+│ Commands to execute:                                                         │
+│ /install-skill anthropics/skills --skill mcp-builder                        │
+│ /install-skill antfu/skills --skill vitest                                  │
+│ /install-skill obra/superpowers --skill error-handling                      │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+## Report File
+
+When using `--report`, a markdown file is generated:
+
+```
+.claude/skills/reports/skills-review-2025-02-26.md
+```
+
+## Category Breakdown
+
+| Category | Skills | KEEP | UPDATE | REPLACE | NEW |
+|----------|--------|------|--------|---------|-----|
+| Core | 4 | 3 | 1 | 0 | 2 |
+| Frontend | 5 | 2 | 2 | 1 | 1 |
+| Backend | 5 | 4 | 1 | 0 | 0 |
+| Architecture | 6 | 5 | 1 | 0 | 0 |
+| DevOps | 5 | 4 | 1 | 0 | 0 |
+| Product | 5 | 3 | 1 | 1 | 1 |
+| Quality | 4 | 2 | 1 | 0 | 0 |
+| Leadership | 4 | 3 | 0 | 0 | 0 |
+
+## Integration
+
+- **Before adding skills**: Run review to avoid duplicates
+- **Monthly audit**: Run `--all` monthly to stay updated
+- **After skills.sh updates**: Re-review for new alternatives
+- **Documentation**: Report files are version-controlled