External Skill Loader
The External Skill Loader provides runtime skill discovery and loading from external sources, including the Skills.sh API (27,000+ community skills), GitHub skill registries, and .well-known endpoints (RFC 8615).Installation
Usage
Basic Example
API Reference
createExternalSkillLoader(options?)
Factory function to create an External Skill Loader instance.
An instance of the External Skill Loader.
search(query, options?)
Search for skills across all enabled sources.
Search query string (e.g., “react testing”, “nextjs deployment”).
start()
Start the loader and initialize cache cleanup intervals.
stop()
Stop the loader and clear cache cleanup intervals.
getCacheStats()
Get cache statistics.
Types
ExternalSkill
Skill metadata from external sources.
Unique skill identifier.
Skill title/name.
Human-readable description of the skill.
Repository source in
owner/repo format.Number of times the skill has been installed.
Relevance score based on search query.
Full SKILL.md content (only populated when
includeContent: true).Raw GitHub URL to the SKILL.md file.
Skills.sh page URL.
GitHub repository URL.
Skill version.
List of tools this skill can use.
Skill tags/categories.
Error message if content fetch failed.
SkillSearchResponse
Response from a skill search operation.
Advanced Usage
Fetching Full Skill Content
Caching Strategy
The loader automatically caches skill content to reduce API calls:- Default cache TTL: 24 hours
- Cache cleanup runs every 5 minutes
- Cached entries are stored in memory
Sources
The loader searches the following sources:- Skills.sh API: Community registry with 27,000+ skills
- GitHub Registries: Direct repository searches
- .well-known Endpoints: RFC 8615 skill discovery