find-skills

Purpose

This skill enables searching and discovering skills in ClaWHub based on criteria like capabilities, categories, ratings, compatibility, and keywords. It helps users locate relevant skills efficiently for integration into AI workflows.

When to Use

Use this skill when you need to discover available skills in ClaWHub, such as finding high-rated skills for a specific task (e.g., code generation), exploring skills by category (e.g., "productivity"), or keyword matching (e.g., "image processing"). Apply it during project setup, skill prototyping, or when expanding AI capabilities.

Key Capabilities

Search skills by capability (e.g., "natural language processing").
Filter by category (e.g., "community" or "enterprise").
Sort by rating (e.g., minimum 4.0 stars).
Check compatibility (e.g., with OpenClaw versions >=1.5).
Perform keyword matching on skill names, descriptions, or tags.
Return results with metadata like ID, name, and tags.

Usage Patterns

Invoke this skill via CLI for quick searches or integrate it into scripts for automated discovery. Use it in loops to fetch and evaluate multiple skills, or combine with other skills for dynamic workflows (e.g., search then execute). Always specify search parameters to avoid broad results; for example, combine keywords with ratings for targeted queries.

Common Commands/API

Use the ClaWHub CLI or API for searches. Authentication requires setting the environment variable $CLAWHUB_API_KEY before running commands.

CLI Command Example:
clawhub find-skills --query "AI coding" --category "community" --min-rating 4.0 --limit 10
This returns up to 10 skills matching the query with at least 4.0 rating.

API Endpoint Example:
POST to https://api.clawhub.com/v1/skills/search with JSON body:

{  
  "query": "web scraping",  
  "category": "tools",  
  "minRating": 3.5,  
  "compatibility": "OpenClaw-v2"  
}

Response is a JSON array of skill objects.

Code Snippet for Python Integration:

import requests  
headers = {'Authorization': f'Bearer {os.environ.get("CLAWHUB_API_KEY")}'}  
response = requests.post('https://api.clawhub.com/v1/skills/search', json={'query': 'data analysis'}, headers=headers)

This fetches skills matching "data analysis".

Config Format:
Store search preferences in a JSON config file (e.g., search-config.json):
```
{  
  "defaultQuery": "AI tools",  
  "defaultCategory": "community"  
}  
```
Pass it to CLI with --config search-config.json.

Integration Notes

Integrate by wrapping the API in your AI agent's code; ensure $CLAWHUB_API_KEY is set securely. For OpenClaw, use the skill ID from results to chain executions (e.g., call execute-skill next). Handle pagination in API responses by checking the nextPageToken field. Test integrations in a sandbox environment to verify compatibility with your agent's version.

Error Handling

Common errors include authentication failures (HTTP 401: check $CLAWHUB_API_KEY), invalid queries (HTTP 400: validate parameters like --query), or rate limits (HTTP 429: add delays). In code, wrap API calls in try-except blocks:

try:  
    response = requests.post(...)  
    response.raise_for_status()  
except requests.exceptions.HTTPError as e:  
    print(f"Error: {e} - Retry after checking API key.")

Log errors with details like error codes and retry up to 3 times with exponential backoff.

Graph Relationships

Related to: "discovery" (tag), "search" (tag), "clawhub" (cluster)
Depends on: "clawhub-api" (for authentication and endpoints)
Used by: "skill-execution" (for discovering skills before running)
Conflicts with: None known
Enhances: "community" cluster skills by providing discovery mechanisms