Integration Guide
Integrate SkillWiki Catalog
Agents can programmatically discover and load skills from the SkillWiki catalog by fetching the machine-readable skill metadata.
Step 1: Discover Skills
Fetch the available skills metadata in XML format:
curl https://skillwiki.ai/available-skills.xmlThis returns a list of all available skills with metadata including name, description, and the location to fetch the full SKILL.md file.
XML Metadata Format
<?xml version="1.0" encoding="UTF-8"?>
<available_skills>
<skill>
<name>frontend-engineer</name>
<description>Senior frontend engineer advisor for TypeScript, Next.js, React, and modern fron...</description>
<domain>development</domain>
<location>https://raw.githubusercontent.com/sophgen/skillwiki/main/skills/development/frontend-engineer/SKILL.md</location>
</skill>
<!-- More skills... -->
</available_skills>Step 2: Load Skills into Agent
Extract skill metadata and include in your agent prompt. Example for Claude:
<available_skills>
<skill>
<name>frontend-engineer</name>
<description>Senior frontend engineer advisor for TypeScript, Next.js, React, and modern fron...</description>
<domain>development</domain>
<location>https://raw.githubusercontent.com/sophgen/skillwiki/main/skills/development/frontend-engineer/SKILL.md</location>
</skill>
</available_skills>Step 3: Activate Skills
When the agent decides to use a skill, fetch the full SKILL.md file:
curl https://raw.githubusercontent.com/sophgen/skillwiki/main/skills/development/frontend-engineer/SKILL.mdThe agent loads the full markdown content and can execute any scripts or reference materials from the skill directory.
Using skills-ref CLI
The agentskills.io project provides a CLI tool for working with skills:
# Validate a skill directory
skills-ref validate ./my-skill
# Generate XML prompt for agent
skills-ref to-prompt ./my-skillLearn more at agentskills.io
Skill Specification
SkillWiki follows the agentskills.io specification. Each skill is a directory containing:
SKILL.md- Required. Contains YAML frontmatter (metadata) and markdown instructionsscripts/- Optional. Executable code files (Python, Bash, JavaScript, etc.)references/- Optional. Additional documentation and reference materialsassets/- Optional. Templates, images, data files
Read the full specification at agentskills.io/specification
Questions?
Open an issue or discussion on our GitHub repository