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.xml

This 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.md

The 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-skill

Learn 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 instructions
  • scripts/ - Optional. Executable code files (Python, Bash, JavaScript, etc.)
  • references/ - Optional. Additional documentation and reference materials
  • assets/ - Optional. Templates, images, data files

Read the full specification at agentskills.io/specification

Questions?

Open an issue or discussion on our GitHub repository