myskill

The Universal CLI for AI Agent Skills

myskill is a powerful command-line tool designed to standardize the creation, management, and sharing of "Agent Skills" across the modern AI coding ecosystem. It abstracts away the differences between platforms like Claude Code, OpenCode, OpenAI Codex, and Gemini CLI, allowing developers to write skills once and deploy them anywhere.

🚀 Key Features

• Unified Creation: Generate valid, schema-compliant skills for any supported platform.
• Strict Validation: Ensure your skills meet platform requirements (YAML frontmatter, file structure).
• Cross-Platform: Works seamlessly on Windows, macOS, and Linux.
• Workspace Management: Initialize skill workspaces and run experimental skills locally.
• Discovery: Fuzzy find installed skills across all global and local scopes.
• Smart Detection: Automatically identify skills in any directory, including nested platform-specific folders.
• Git Integration: Pull and update skills directly from remote repositories.
• Interactive Experience: Step-by-step guides with Multi-selection support for bulk actions.
• Configurable Paths: Override default platform paths for custom setups.
• Onboarding: Built-in guide for AI agents to understand the codebase.

📦 Installation

npm install -g myskill

🛠️ Supported Platforms

Platform	ID	Key Features Supported
Claude Code	claude	allowed-tools, context: fork, hooks
OpenCode	opencode	license, compatibility, metadata
OpenAI Codex	codex	short-description metadata
Gemini CLI	gemini	Standard skill structure

📖 Usage Guide

Creating Skills

Create a new skill interactively:

myskill create
# Cancel anytime with Escape key or Ctrl+C

Discovering Skills

Detect skills in the current directory and platform-specific subfolders:

myskill detect

List all installed skills for a platform:

myskill list --platform claude

Sharing Skills

Install a local skill directory to the global platform path (supports auto-detection and interactive selection):

myskill install

Uninstall skills with multi-selection support:

myskill uninstall

Configuration & Help

List documentation URLs for all platforms:

myskill docs

Display onboarding guide for AI agents:

myskill onboard

Override default paths:

myskill config set claude.path "/custom/path/to/skills"
myskill config list

🔧 Command Reference

Command	Description	Usage	Options
create	Create a new skill interactively or via flags.	myskill create [options]	-n, --name <name>: Skill name -p, --platform <platform>: Target platform -d, --description <description>: Skill description -s, --scope <scope>: Scope (global, project). Default: project --non-interactive: Run without interactive prompts
list	List all installed skills for a platform.	myskill list [options]	-p, --platform <platform>: Filter by platform
platforms	List all supported platforms.	myskill platforms	None
detect	Detect skills in directory and platform folders.	myskill detect [path]	[path]: Path to directory to scan (default: current directory)
docs	List documentation URLs for all platforms.	myskill docs	None
onboard	Display onboarding guide for AI agents.	myskill onboard	None
find	Find skills by name or description with fuzzy search.	myskill find [query] [options]	[query]: Search query -p, --platform <platform>: Filter by platform
validate	Validate a skill's structure and frontmatter against platform schemas.	myskill validate [path] [options]	[path]: Path to skill directory. Default: current directory -p, --platform <platform>: Validate against specific platform
run	Run a skill script (experimental).	myskill run <skill> [args...]	<skill>: Skill name or path [args...]: Arguments to pass to the skill script
install	Install a local skill to the global platform path.	myskill install [path] [options]	[path]: Path to skill directory (optional - auto-detects if omitted) -p, --platform <platform>: Target platform -f, --force: Force overwrite --non-interactive: Run without prompts
pull	Pull (clone/update) a skill from a Git repository.	myskill pull <repoUrl> [options]	<repoUrl>: Repository URL -p, --platform <platform>: Target platform -n, --name <name>: Custom skill name --non-interactive: Skip prompts
convert	Convert a skill from one platform format to another.	myskill convert <path> [options]	<path>: Path to source skill -t, --to <platform>: Target platform -f, --force: Force overwrite --non-interactive: Fail if output exists
uninstall	Uninstall one or more skills from global or local paths.	myskill uninstall [name] [options]	[name]: Skill name (optional - triggers multi-select if omitted) -p, --platform <platform>: Platform context --non-interactive: Skip confirmation
config	Manage configuration settings (e.g., custom paths).	myskill config <action> [key] [value]	<action>: Action (get, set, list) [key]: Config key (e.g., claude.path) [value]: Config value (for set)
doctor	Check system health (Git, permissions, paths).	myskill doctor	None

🗺️ Roadmap

• Ecosystem & Sharing: Implement myskill publish to upload skills to a central registry (S3, GitHub Packages, or a custom index).
• Generate from Prompt: myskill create --prompt "A skill that checks AWS S3 buckets". Use an LLM API to generate the SKILL.md content and initial script code.