Skip to content
This repository was archived by the owner on Mar 13, 2026. It is now read-only.

claude-world/skill-universal

Skill Universal 🌍

License: MIT Python Version TypeScript CI/CD codecov

Write your Skill once, run everywhere - from Claude Code to Agent SDK, OpenClaw, and beyond.

Skill Universal demonstrates how declarative Skills (Claude Code Skills format) can be loaded and executed across different Agent platforms.

🌟 Why This Matters

The NΓ—N Problem

Traditional agent development: N tools = N! possible workflow combinations

When you have N tools, creating agents for every possible workflow becomes unmanageable.

The Solution

Skills provide intelligent aggregation: N tools + 1 router = all possible combinations

Skills act as:

  • Tool Aggregators - Combine existing capabilities
  • Decision Engines - Replace human judgment with AI decisions
  • Execution Coordinators - Optimize workflows dynamically

πŸš€ Quick Start

For Claude Code Users

Just create a .claude/skills/my-skill/SKILL.md file!

---
name: research
description: Research expert
triggers:
  - "research"
  - "study"
tools:
  - WebSearch
  - WebFetch
---

## Research any topic efficiently...

### 1. Search
Search for "[topic] tutorial 2026"

### 2. Fetch Documentation
Read official documentation

### 3. Summarize
Create comprehensive summary

For Agent SDK Users (Python)

from skill_universal import SkillLoader

loader = SkillLoader()
skill = loader.load("skills/my-skill/SKILL.md")
agent = skill.to_agent_sdk()

# Use with Anthropic Agent SDK
# agent.create() returns properly configured agent

For OpenClaw Users (TypeScript)

import { SkillLoader } from 'skill-universal';

const loader = new SkillLoader();
const skill = await loader.load('skills/my-skill/SKILL.md');
const openclawSkill = skill.to_openclaw();

// Deploy to OpenClaw platform
// openclawSkill contains proper tool mappings

πŸ“š What's Included

Example Skills

Skill Description Tools Used
Tech Research Research any technology topic WebSearch, WebFetch, Read, Write, Grep
Document Processor Process PDF/Word/Markdown Read, Write, Bash
GitHub Analyzer Analyze repositories WebSearch, WebFetch, Read, Grep
Customer Support Multi-source support aggregation WebSearch, WebFetch, Read

Loaders

  • Python (loaders/python/skill_loader.py) - Load Skills in Python/Agent SDK
  • TypeScript (loaders/typescript/SkillLoader.ts) - Load Skills in TypeScript/Node.js/OpenClaw

πŸ“¦ Installation

From PyPI (Python)

pip install skill-universal

From npm (TypeScript)

npm install skill-universal

From Source

git clone https://github.com/claude-world/skill-universal.git
cd skill-universal

# Python
pip install -e .

# TypeScript
npm install
npm run build

πŸ’‘ Use Cases

1. Research Automation

Automate research across web, GitHub, and community discussions.

2. Document Processing

Process PDF, Word, and Markdown documents with consistent interface.

3. Repository Analysis

Analyze GitHub repositories for tech stack, dependencies, and metrics.

4. Customer Support

Aggregate knowledge from multiple sources for intelligent support.

πŸ—οΈ Project Structure

skill-universal/
β”œβ”€β”€ skills/           # Example Skills (SKILL.md format)
β”‚   β”œβ”€β”€ tech-research/
β”‚   β”œβ”€β”€ document-processor/
β”‚   β”œβ”€β”€ github-analyzer/
β”‚   └── customer-support/
β”œβ”€β”€ loaders/          # Platform-specific loaders
β”‚   β”œβ”€β”€ python/       # Python/Agent SDK loader
β”‚   β”‚   β”œβ”€β”€ skill_loader.py
β”‚   β”‚   └── tests/
β”‚   └── typescript/   # TypeScript loader
β”‚       β”œβ”€β”€ SkillLoader.ts
β”‚       └── tests/
β”œβ”€β”€ examples/         # Usage examples
β”‚   β”œβ”€β”€ claude-code/
β”‚   β”œβ”€β”€ agent-sdk/
β”‚   └── openclaw/
β”œβ”€β”€ tests/            # Integration tests
β”œβ”€β”€ docs/             # Documentation (EN/ZH-TW/JA)
β”œβ”€β”€ .github/          # GitHub Actions, issue templates
β”œβ”€β”€ pyproject.toml    # Python packaging
β”œβ”€β”€ package.json      # TypeScript packaging
└── README.md

πŸ§ͺ Testing

# Python tests
pytest tests/

# TypeScript tests
npm test

# All tests
npm run test:all

πŸ“– Documentation

🀝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

πŸ“Š Status

GitHub Stars GitHub Forks GitHub Issues

πŸ—ΊοΈ Roadmap

  • Core skill loading (Python, TypeScript)
  • Example skills
  • Claude Code format support
  • Agent SDK format support
  • OpenClaw format support
  • PyPI package publishing
  • npm package publishing
  • More platform support (LangChain, LlamaIndex, etc.)
  • Skill marketplace
  • Web UI for skill creation

πŸ“ License

MIT License - see LICENSE

πŸ™ Acknowledgments

πŸ”— Links


Made with ❀️ by the Claude World Community

About

Universal Skill Loader - Write Skills once, run everywhere (Claude Code, Agent SDK, OpenClaw)

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors