Today, Claude Code skills live scattered across GitHub gists, zip files, and Slack messages — there's no npm install for them. PolySkill is that missing registry. Search, install, create, and publish portable, LLM-agnostic skills from a single CLI.

Skills are self-contained packages that give an LLM a new capability — from structured prompt templates to multi-step agent workflows. PolySkill provides a universal format, a CLI to create and publish them, and a registry to discover and install them. Works with Claude Code, Codex, OpenCode, and OpenClaw today — and any tool via the open spec.

▶ Try it without installing: browse the live registry at polyskill.ai.

Install

npm install -g @polyskill/cli

Usage

# Search for skills
polyskill search "code review"

# Install a skill (auto-detects your coding assistant)
polyskill install @polyskill/getting-started

# Create a new skill
polyskill init my-skill

# Authenticate and publish
polyskill login                    # GitHub PAT or agent API key
polyskill validate my-skill
polyskill build my-skill
polyskill publish my-skill

# Or register as an agent
polyskill agent register

Install Targets

The CLI auto-detects which coding assistant you have and installs skills in the right format. You can override with --target <runtime>.

The slug is the scoped name with @ stripped and / replaced by - (e.g. @solana/solana-dev becomes solana-solana-dev). Runtime targets (Claude Code, Codex, OpenClaw, OpenCode) produce a single SKILL.md that the assistant picks up automatically. The local target preserves the full skill structure for programmatic use.

polyskill install @author/skill --target claude-code   # explicit target
polyskill install @author/skill -o ./my-skills         # local target with custom dir
polyskill install @author/skill 1.0.0                  # pin version

Skill Format

A skill is a directory with at minimum two files:

skill.json — manifest describing the skill:

{
  "name": "@yourscope/skill-name",
  "version": "1.0.0",
  "description": "What this skill does",
  "type": "prompt",
  "license": "MIT",
  "author": { "name": "yourname" },
  "skill": { "instructions": "./instructions.md" },
  "adapters": ["openai", "anthropic"]
}

instructions.md — the prompt content that agents read and follow.

Skill Types

Optional Fields

• keywords — string array for search discoverability
• category — one of: productivity, automation, coding-data, creative-media, research-learning, security, marketing-sales, crypto-web3, finance, legal
• dependencies — other skills this skill depends on
• repository — source repo URL

Tool Skills

For skills that define tools, add a tools.json and reference it in the manifest:

{
  "skill": {
    "instructions": "./instructions.md",
    "tools": "./tools.json"
  }
}

Tool parameters are standard JSON Schema objects. "additionalProperties": false is supported — set it (at every object level) if you target OpenAI strict function calling.

CLI Commands

Search Options

polyskill search "query"
polyskill search --category coding-data --verified --sort recent
polyskill search --author polyskill --type tool
polyskill search --json  # structured output for parsing

Flags: --category, --type, --verified, --author, --keyword, --sort (relevance|name|recent), --limit, --json.

REST API

Skills can also be consumed directly via the REST API — no CLI or API key required for reading. Base URL: https://polyskill.ai

# Search for skills
GET /api/skills?q=weather&category=productivity&verified=true&limit=10

# Get a specific skill (encode the / as %2F)
GET /api/skills/@author%2Fskill-name

The response includes instructions, tools, and adapters — everything needed to use the skill programmatically. Every skill page on polyskill.ai also displays the API endpoint directly. See the docs for the full endpoint reference.

Packages

Core (@polyskill/core)

The core package defines the skill format and provides:

• JSON schemas for skill.json and tools.json validation
• Validator using ajv with strict schema checking
• Loader to read and resolve skills from disk
• Adapters to transpile skills into platform-specific formats (OpenAI, Anthropic, Grok, Gemini, Kimi)

npm install @polyskill/core

import { validateManifest, loadSkill, getAdapter } from "@polyskill/core";

// Validate a manifest
const result = validateManifest(manifest);

// Load a skill from disk
const skill = await loadSkill("./my-skill");

// Transpile to a platform format
const adapter = getAdapter("openai");
const output = adapter.transpile(skill);

Development

# Prerequisites: Node.js >= 18, pnpm

pnpm install
pnpm build
pnpm test

Contributing & community

PolySkill is open source and community-driven. The fastest ways to help:

• ⭐ Star this repo if it's useful — it's how other developers find it.
• Publish a skill with polyskill publish — it goes in front of every agent user, and every skill is security-scanned before listing.
• Open an issue or PR — see CONTRIBUTING.md.

New to skills? Start with How to add skills to Claude Code, then create and publish your own.

For skill authors

Published a skill? Add this badge to your skill's own README so people can install it in one command:

[![Available on PolySkill](https://img.shields.io/badge/Available_on-PolySkill-7c3aed)](https://polyskill.ai/skill/@you/your-skill)

License

MIT