OpenSkills CLI

中文 | English

---

中文

概述

OpenSkills CLI 是一个用于发现、安装和管理 Claude Code 技能的命令行工具。它提供了一个集中式市场，用于共享和分发可复用的 AI 能力。

功能特性

• 搜索技能：从 OpenSkills 市场查找技能
• 安装技能：下载并安装技能到你的项目
• 自动升级：保持 CLI 和技能处于最新版本
• 锁定文件：通过版本控制跟踪已安装的技能

安装

curl -fsSL http://oss.openskills.cn/install.sh | bash

或手动下载安装：

curl -fsSL http://oss.openskills.cn/latest.tar.gz -o latest.tar.gz
tar -xzf latest.tar.gz
cd cli && bash install.sh

使用方法

搜索技能

openskills search <关键词>

示例：

openskills search twitter
openskills search 搜索

安装技能

openskills install <技能标识>

示例：

openskills install x-search

技能将被安装到当前目录的 ./skills/<技能标识>/。

升级 CLI

openskills upgrade

项目结构

openskillscli/
├── cli/                    # CLI 工具源代码
│   ├── skills_cli.py      # 主 CLI 实现
│   ├── skills_upgrade.py  # 自升级功能
│   ├── install.sh         # 安装脚本
│   ├── metadata.json      # API 端点配置
│   └── version.json       # CLI 版本
├── skills/                # 已安装技能目录
│   └── x-search/         # 示例：X (Twitter) 搜索技能
├── tests/                 # 测试套件
├── scripts/              # 构建和发布脚本
└── install.sh            # 快速安装脚本

工作原理

1. 搜索：查询 OpenSkills API 获取可用技能
2. 安装：下载技能包（.zip）并解压到 ./skills/
3. 锁定：在 .skills_lock.json 中记录已安装的技能
4. 加载：Claude Code 自动从 ./skills/ 目录加载技能

配置

CLI 配置存储在 ~/.openskills/：

• metadata.json：API 端点
• version.json：已安装的 CLI 版本
• config.json：用户偏好设置

系统要求

• Python 3.6+
• curl（用于安装）
• Claude Code（用于使用已安装的技能）

---

English

Overview

OpenSkills CLI is a command-line tool for discovering, installing, and managing skills for Claude Code. It provides a centralized marketplace for sharing and distributing reusable AI capabilities.

Features

• Search Skills: Find skills from the OpenSkills marketplace
• Install Skills: Download and install skills to your project
• Auto-upgrade: Keep your CLI and skills up to date
• Lock File: Track installed skills with version control

Installation

curl -fsSL http://oss.openskills.cn/install.sh | bash

Or download and install manually:

curl -fsSL http://oss.openskills.cn/latest.tar.gz -o latest.tar.gz
tar -xzf latest.tar.gz
cd cli && bash install.sh

Usage

Search for skills

openskills search <keyword>

Example:

openskills search twitter
openskills search 搜索

Install a skill

openskills install <skill-slug>

Example:

openskills install x-search

Skills are installed to ./skills/<skill-slug>/ in your current directory.

Upgrade CLI

openskills upgrade

Project Structure

openskillscli/
├── cli/                    # CLI tool source code
│   ├── skills_cli.py      # Main CLI implementation
│   ├── skills_upgrade.py  # Self-upgrade functionality
│   ├── install.sh         # Installation script
│   ├── metadata.json      # API endpoints configuration
│   └── version.json       # CLI version
├── skills/                # Installed skills directory
│   └── x-search/         # Example: X (Twitter) search skill
├── tests/                 # Test suite
├── scripts/              # Build and release scripts
└── install.sh            # Quick install script

How It Works

1. Search: Query the OpenSkills API for available skills
2. Install: Download skill packages (.zip) and extract to ./skills/
3. Lock: Record installed skills in .skills_lock.json
4. Load: Claude Code automatically loads skills from ./skills/ directory

Configuration

CLI configuration is stored in ~/.openskills/:

• metadata.json: API endpoints
• version.json: Installed CLI version
• config.json: User preferences

Requirements

• Python 3.6+
• curl (for installation)
• Claude Code (to use installed skills)

---

License

MIT