skill-management

Full lifecycle skill management system

Complete skill management workflow, end-to-end management from discovery to deployment,Making full use of LLM intelligent analysis capabilities。

🎯 Core Features

1. Three data source searches

GitHub - Search skill repositories on GitHub
skills.sh marketplace - Search the skills.sh skill marketplace
Skills CLI - Use npx skills CLI to search and install skills (based on Vercel's open source solution)

2. Intelligent skill classification

Automatically identify skill types: knowledge, tool, hybrid, process
Differentiated evaluation criteria

3. In-depth LLM analysis

Intelligent classification
In-depth evaluation
Security audit
Customized reports

4. Differentiated evaluation

Knowledge-based: focus on evaluating content quality (40%)
Tool-based: focus on evaluating functionality and security (40%)

5. Skills CLI integration

Based on Vercel skills open source solution, providing:

Search skills - npx skills find <keyword>
Install skills - npx skills add <owner/repo@skill>
Check for updates - npx skills check
Update skills - npx skills update

🔄 Workflow

┌─────────────┐
│  搜索技能   │ ← 脚本：GitHub CLI 或 skills.sh marketplace
└──────┬──────┘
       │
┌──────▼──────┐
│  选择技能   │ ← LLM：使用 interview 展示列表 + 智能介绍
└──────┬──────┘
       │
┌──────▼──────┐
│  发现技能   │ ← 脚本：克隆仓库、查找 SKILL.md
└──────┬──────┘
       │
┌──────▼──────┐
│  智能分类   │ ← LLM：判断技能类型
└──────┬──────┘
       │
┌──────▼──────┐
│  评估技能   │ ← LLM：差异化分析
└──────┬──────┘
       │
┌──────▼──────┐
│  安全审计   │ ← LLM：差异化审计
└──────┬──────┘
       │
┌──────▼──────┐
│  适应性改造 │ ← 脚本：分析需求
└──────┬──────┘
       │
┌──────▼──────┐
│  融合测试   │ ← 脚本：兼容性检查
└──────┬──────┘
       │
┌──────▼──────┐
│  智能报告   │ ← LLM：定制化报告
└──────┬──────┘
       │
┌──────▼──────┐
│  用户通知   │ ← 脚本：显示摘要
└─────────────┘

🚀 Quick Start

Search skills

GitHub search

bun ~/.pi/agent/skills/skill-management/scripts/search.ts "claude office"

skills.sh marketplace search

bun ~/.pi/agent/skills/skill-management/scripts/search.ts "react" --source marketplace

Skills CLI search

bun ~/.pi/agent/skills/skill-management/scripts/search.ts "react" --source cli

Install directly using Skills CLI

# 搜索技能
npx skills find react

# 安装特定技能
npx skills add vercel-labs/agent-skills@vercel-react-best-practices

# 检查更新
npx skills check

# 更新所有技能
npx skills update

View popular skills

bun ~/.pi/agent/skills/skill-management/scripts/search.ts trending

View statistics

bun ~/.pi/agent/skills/skill-management/scripts/search.ts stats

Complete workflow

# 使用 GitHub 搜索
bun ~/.pi/agent/skills/skill-management/scripts/pipeline.ts "claude office" --interactive

# 使用 marketplace 搜索
bun ~/.pi/agent/skills/skill-management/scripts/pipeline.ts "react" --source marketplace --interactive

🤖 LLM Intelligent Analysis

Intelligent classification

Automatically identify 4 skill types:

knowledge - Pure documentation, guides, best practices
tool - Includes executable scripts and tools
hybrid - Has both documentation and scripts
process - Process guides and workflows

Differentiated evaluation

Dimension	Knowledge-based	Tool-based
Content quality	40%	20%
Functional completeness	20%	40%
Practicality	20%	20%
Documentation quality	10%	10%
Code quality	5%	10%
Security	5%	10%

📁 File Structure

~/.pi/agent/skills/skill-management/
├── SKILL.md                    # 本文档
├── README.md                   # 使用说明
├── config.json                 # 配置文件
├── scripts/
│   ├── assess.ts              # 智能评估（自动分类 + 差异化）
│   ├── audit.ts               # 智能审计（自动分类 + 差异化）
│   ├── pipeline.ts            # 完整流程脚本
│   ├── select.ts              # 技能选择脚本
│   ├── search.ts              # 三数据源搜索（GitHub + marketplace + CLI）
│   ├── skills-cli.ts          # Skills CLI (npx skills) 集成模块
│   ├── interactive.ts         # 交互式决策脚本
│   ├── report.ts              # 智能报告生成脚本
│   └── notify.ts              # 通知脚本
├── reports/                    # 智能评估报告目录
└── templates/                  # 模板文件

🎨 Data Source Comparison

Data source	Type	Advantages	Purpose
GitHub	Code repository	Search open source skill projects	Search skill repositories on GitHub
skills.sh	Skill marketplace	Skill aggregation platform	Discover popular and community skills
Skills CLI	Package manager	Unified skill ecosystem	Search, install, and update skills

📝 Usage Examples

Example 1: GitHub search

bun ~/.pi/agent/skills/skill-management/scripts/search.ts "office"

Example 2: Marketplace search

bun ~/.pi/agent/skills/skill-management/scripts/search.ts "react" --source marketplace

Example 3: View popular skills

bun ~/.pi/agent/skills/skill-management/scripts/search.ts trending

Example 4: View statistics

bun ~/.pi/agent/skills/skill-management/scripts/search.ts stats

🎯 Best Practices

Search first, then choose - Use three data sources to search for more skills
Make full use of LLMs - LLMs participate in the entire analysis process
Differentiate skill types - Use different evaluation criteria for different types
Customized reports - Generate customized reports based on the type
Prioritize using the Skills CLI - For skills in the skills.sh ecosystem, use npx skills to install and manage
Skill naming format - Use the owner/repo@skill-name format to reference a specific skill