--- slug: "myskill-myskill" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/sarfraznawaz2005/myskill@main/README.md" repo: "https://github.com/sarfraznawaz2005/myskill" source_file: "README.md" branch: "main" --- # 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 ```bash 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: ```bash myskill create # Cancel anytime with Escape key or Ctrl+C ``` ### Discovering Skills Detect skills in the current directory and platform-specific subfolders: ```bash myskill detect ``` List all installed skills for a platform: ```bash myskill list --platform claude ``` ### Sharing Skills Install a local skill directory to the global platform path (supports auto-detection and interactive selection): ```bash myskill install ``` Uninstall skills with **multi-selection** support: ```bash myskill uninstall ``` ### Configuration & Help List documentation URLs for all platforms: ```bash myskill docs ``` Display onboarding guide for AI agents: ```bash myskill onboard ``` Override default paths: ```bash 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 `: Skill name
`-p, --platform `: Target platform
`-d, --description `: Skill description
`-s, --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 `: 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 `: 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 `: Validate against specific platform | | `run` | Run a skill script (experimental). | `myskill run [args...]` | ``: 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 `: Target platform
`-f, --force`: Force overwrite
`--non-interactive`: Run without prompts | | `pull` | Pull (clone/update) a skill from a Git repository. | `myskill pull [options]` | ``: Repository URL
`-p, --platform `: Target platform
`-n, --name `: Custom skill name
`--non-interactive`: Skip prompts | | `convert` | Convert a skill from one platform format to another. | `myskill convert [options]` | ``: Path to source skill
`-t, --to `: 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 context
`--non-interactive`: Skip confirmation | | `config` | Manage configuration settings (e.g., custom paths). | `myskill config [key] [value]` | ``: 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.