Laravel Package Search - Skill Specification#

Overview#

Skill Name: Laravel Package Search Type: Development Assistant Skill Target: Laravel developers seeking efficient plugin selection Engine: OpenClaw Agent

---

1. Core Objectives#

• Real-time Packagist API — data never stale, always fresh
• Local cache (1 hour TTL) — fast repeat queries
• Score packages by: stars × downloads × activity × Laravel compatibility
• Support 22 scene categories including AI/LLM, rate-limit, Stripe, SMS
• Cross-reference to laravel-docs-reader for official Laravel documentation
• Provide install commands + config snippets

---

2. Scene Categories#

Supported Scenes#

SceneChineseDescriptionauth认证/权限Authentication, authorization, roles, permissionspayment支付/订单Payment gateways, Stripe, Alipay, WeChat Paymultitenancy多租户Multi-tenant SaaS applicationsexcelExcel/导入导出Spreadsheet import/export, data processingmedia媒体/文件File uploads, media management, CDNwechat微信WeChat SDK, Mini Programqueue队列/任务Job queues, Laravel Horizonadmin后台管理Admin panels, Filamentsearch搜索/全文检索Full-text search, Algolia, Scoutlogging日志/审计Logging, audit trailsapiAPI/SDKREST API, GraphQL, Sanctumtesting测试Pest, PHPUnitcache缓存Redis, cache managementsecurity安全Security headers, CSRFdevtools开发工具Debug, Telescope, Debugbaremail邮件Mailgun, notificationsstorage存储S3, cloud storageui前端/UIVue, React, Inertia, BreezeaiAI/LLM集成OpenAI, LLM, chatbotratelimit限流Rate limiting, throttlestripeStripe支付Stripe subscriptions & paymentssms短信Twilio, SMS notifications

---

3. Package Evaluation Criteria#

Each package is scored in real-time via Packagist API (live data):

CriterionWeightSourceGitHub Stars15%Packagist API (github_stars field)Packagist Downloads20%Packagist API (downloads.total)Favorites10%Packagist API (favers)Maintenance Activity30%Last commit time (≤30d=100, ≤1y=40, >2y=0)Laravel Compatibility15%composer.json require (10/11/12)Description Quality10%Non-empty description = 100

Real-time Scoring#

text

Score = min(100, stars/500)*0.15 + min(100, log10(downloads)*15)*0.20
      + min(100, favers/200)*0.10 + activityScore*0.30
      + (hasLaravelVersion ? 100 : 0)*0.15 + (hasDescription ? 100 : 0)*0.10

Data fetched live from Packagist API. Cached for 1 hour in scripts/.cache.json.

---

4. Top 20 Laravel Packages#

Run php search.php top 20 for live rankings

---

5. Smart Recommendation Logic#

When a user describes their needs:

1. Parse Intent → Map to scene category
2. Match Packages → Find packages in that scene
3. Filter → Remove incompatible versions
4. Sort → By recommendation score
5. Output → Top 3 recommendations with reasoning

Output Template#

text

## 🎯 Recommended for: [User's Scenario]

**Top Pick**: [Package Name]
- **Why**: [Recommendation Reason]
- **Alternative**: [Alternative Package]
- **Caution**: [Any concerns]
- **Install**: `composer require [package]`
- **Compatibility**: Laravel X / Y / Z

---

**Alternative 1**: [Name] ...
**Alternative 2**: [Name] ...

---

6. Installation & Configuration#

Each package entry includes:

bash

composer require vendor/package

php

// config/services.php or dedicated config file
'package' => [
    'key' => env('PACKAGE_KEY'),
],

php

// app/Providers/AppServiceProvider.php
public function register(): void
{
    $this->mergeConfigFrom(...);
}

---

7. Version Compatibility#

LaravelCompatible PackagesLaravel 12Packages updated after 2024-Q4Laravel 11Packages updated after 2023-Q2Laravel 10Packages updated after 2022-Q1

Always verify: composer show vendor/package --tree | grep laravel/framework

---

8. CLI Tool (scripts/search.php)#

Real-time Packagist API with local caching. No static data.

Commands#

bash

php search.php <command> [args]

CommandArgsDescriptionsearch``<scene> [limit]Search by scene (auth, payment, ai...)compare``<pkg1> <pkg2>Compare two packagesrecommend``<requirement>Natural language recommendationtop``[limit]Show Top N packages (default 10)scenes—List all 22 scene categories

Examples#

bash

# Search AI packages
php search.php search ai 3

# Compare two auth packages
php search.php compare spatie/laravel-permission laravel/sanctum

# Natural language recommendation
php search.php recommend "I need WeChat Pay for Laravel 11"
php search.php recommend "I need AI chat for Laravel"
php search.php recommend "I need rate limiting"

# Top 20 packages
php search.php top 20

# All scenes
php search.php scenes

Caching#

text

Cache file: scripts/.cache.json (auto-created)
TTL: 1 hour

Integration with OpenClaw Agent#

When the agent receives a package query, it calls php search.php and formats the output. If the user asks about Laravel official docs, it cross-references laravel-docs-reader skill.

---

8b. laravel-docs-reader Cross-Reference#

This skill automatically cross-references Laravel official documentation for known packages:

text

Package → Official Laravel Docs
spatie/laravel-permission → Authorization docs
laravel/scout → Database Search docs
laravel/horizon → Queues docs
laravel/telescope → Debugging docs
laravel/sanctum → SPA Authentication docs
laravel/cashier → Billing docs
laravel/fortify → Authentication docs
filament/filament → filamentphp.com/docs
maatwebsite/excel → docs.laravel-excel.com

For packages not in the map, the output includes:

text

📖 Laravel Docs: Run `laravel-docs-reader` to search official docs for this package

Workflow#

1. User asks: "recommend a Laravel auth package"
2. This skill returns ranked packages with install commands
3. Output includes: 📖 Laravel Docs: Run laravel-docs-reader to search official docs
4. User can then ask: "search laravel-docs-reader for sanctum setup"
5. laravel-docs-reader handles the official documentation query

---

Activation Keywords#

• "帮我找个 Laravel 插件"
• "Laravel package for XXX"
• "推荐 Laravel 认证插件"
• "Laravel auth package recommendation"
• "帮我评估这个包"
• "compare Laravel packages"

Workflow#

1. User describes requirement (Chinese or English)
2. Skill identifies scene category
3. Skill searches Top20 + scene database
4. Skill returns ranked recommendations
5. User selects → Skill provides install + config

---

10. Data Sources#

• Packagist API: https://packagist.org/api/search.json?q=
• GitHub API: https://api.github.com/repos/{vendor}/{package}
• GitHub Trending: Community activity
• Official Laravel Packages: laravel.com/packages

---

11. File Structure#

text

laravel-package-search/
├── SKILL.md                          # This file
├── references/
│   └── scene-index.md                # Scene category index
└── scripts/
    └── search.php                    # Real-time Packagist CLI (v3)

---

12. Publishing to Skills Market#

bash

clawhub login
clawhub publish laravel-package-search

Or submit to ClawHub website for review.

---

13. Maintenance#

• Update Top 20 quarterly
• Add new scenes as Laravel ecosystem evolves
• Track deprecated packages and mark them
• Update compatibility for new Laravel releases