SkillsMP API Skill

Access the SkillsMP API for searching and discovering AI skills built by the community.

Quick Start

1. Set API Key

export SKILLSMP_API_KEY="your-api-key-here"

2. Use the Python Client

# Search skills by keyword
python scripts/skillsmp_api.py search "SEO"

# AI semantic search
python scripts/skillsmp_api.py ai-search "How to create a web scraper"

3. Or Use Directly

# Keyword search
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
-H "Authorization: Bearer $SKILLSMP_API_KEY"

# AI search
curl -X GET "https://skillsmp.com/api/v1/skills/ai-search?q=How+to+scrape+websites" \
-H "Authorization: Bearer $SKILLSMP_API_KEY"

Bundled Resources

Python Client (scripts/skillsmp_api.py)

A complete Python client with:

• •SkillsMPAPI class for programmatic access
• •CLI interface for quick searches
• •Error handling and type hints
• •Two search methods: search() and ai_search()

Usage in your code:

from skillsmp_api import SkillsMPAPI

client = SkillsMPAPI()
results = client.search("SEO", sort_by="stars")

API Reference (references/api_reference.md)

Complete documentation including:

• •All endpoints and parameters
• •Response formats
• •Error codes
• •Rate limits
• •Best practices
• •Additional examples

When to Use This Skill

• •Finding specific skills: Use keyword search for terms like "SEO", "web scraping", "data analysis"
• •Natural language queries: Use AI search for questions like "How do I automate social media posting?"
• •Exploring: Search with sortBy=stars for popular skills or sortBy=recent for new additions
• •Building integrations: Use the Python client for programmatic access

Error Handling

The API returns errors in this format:

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}

Common error codes: MISSING_API_KEY, INVALID_API_KEY, MISSING_QUERY, INTERNAL_ERROR

Best Practices

1. •Always use environment variables for API keys
2. •Handle errors gracefully - check the success field
3. •Use appropriate search type:
   • •Keyword search for specific terms
   • •AI search for natural language questions
4. •Respect rate limits - use pagination for large result sets
5. •Use the Python client for complex operations

References

• •Full API Documentation: See references/api_reference.md
• •Python Client: See scripts/skillsmp_api.py
• •API Website: https://skillsmp.com/docs/api
• •Note: SkillsMP is not affiliated with Anthropic