Back to Details

skill-manager

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Lifecycle Manager

Skill 生命周期管理器

This skill helps you maintain your library of GitHub-wrapped skills by automating the detection of updates and assisting in the refactoring process.
该Skill可通过自动检测更新并协助重构流程，帮助你维护基于GitHub封装的Skill库。

Core Capabilities

核心功能

  1. Audit: Scans your local skills folder for skills with 
    github_url
    metadata.
  2. Check: Queries GitHub (via 
    git ls-remote
    ) to compare local commit hashes against the latest remote HEAD.
  3. Report: Generates a status report identifying which skills are "Stale" or "Current".
  4. Update Workflow: Provides a structured process for the Agent to upgrade a skill.
  5. Inventory Management: Lists all local skills and provides deletion capabilities.
  1. 审计：扫描本地Skill文件夹，查找包含
    github_url
    元数据的Skill。
  2. 检查：通过
    git ls-remote
    查询GitHub，对比本地提交哈希与远程最新HEAD。
  3. 报告：生成状态报告，标记哪些Skill是“过时”或“当前最新”。
  4. 更新流程：为Agent提供结构化的Skill升级流程。
  5. 库存管理：列出所有本地Skill并提供删除功能。

Usage

使用方法

Trigger: 
/skill-manager check
or "Scan my skills for updates" Trigger: 
/skill-manager list
or "List my skills" Trigger: 
/skill-manager delete <skill_name>
or "Delete skill <skill_name>"
触发方式：
/skill-manager check
或 “扫描我的Skill以获取更新” 触发方式：
/skill-manager list
或 “列出我的Skill” 触发方式：
/skill-manager delete <skill_name>
或 “删除Skill <skill_name>”

Workflow 1: Check for Updates

流程1：检查更新

  1. Run Scanner: The agent runs 
    scripts/scan_and_check.py
    to analyze all skills.
  2. Review Report: The script outputs a JSON summary. The Agent presents this to the user.
    • Example: "Found 3 outdated skills: 
      yt-dlp
      (behind 50 commits), 
      ffmpeg-tool
      (behind 2 commits)..."
  1. 运行扫描器：Agent执行
    scripts/scan_and_check.py
    来分析所有Skill。
  2. 查看报告：脚本输出JSON摘要，Agent将其呈现给用户。
    • 示例：“发现3个过时的Skill：
      yt-dlp
      （落后50次提交）、
      ffmpeg-tool
      （落后2次提交）...”

Workflow 2: Update a Skill

流程2：更新Skill

Trigger: "Update [Skill Name]" (after a check)
  1. Fetch New Context: The agent fetches the new README from the remote repo.
  2. Diff Analysis:
    • The agent compares the new README with the old 
      SKILL.md
      .
    • Identifies new features, deprecated flags, or usage changes.
  3. Refactor:
    • The agent rewrites 
      SKILL.md
      to reflect the new capabilities.
    • The agent updates the 
      github_hash
      in the frontmatter.
    • The agent (optionally) attempts to update the 
      wrapper.py
      if CLI args have changed.
  4. Verify: Runs a quick validation (if available).
触发方式：“更新[Skill名称]”（检查之后）
  1. 获取新内容：Agent从远程仓库获取新的README。
  2. 差异分析:
    • Agent将新README与旧的
      SKILL.md
      进行对比。
    • 识别新功能、已弃用的参数或使用方式变更。
  3. 重构:
    • Agent重写
      SKILL.md
      以体现新功能。
    • Agent更新前置元数据中的
      github_hash
      。
    • 如果CLI参数发生变化，Agent（可选）尝试更新
      wrapper.py
      。
  4. 验证：运行快速验证（如果可用）。

Scripts

脚本

  • scripts/scan_and_check.py
    : The workhorse. Scans directories, parses Frontmatter, fetches remote tags, returns status.
  • scripts/update_helper.py
    : (Optional) Helper to backup files before update.
  • scripts/list_skills.py
    : Lists all installed skills with type and version.
  • scripts/delete_skill.py
    : Permanently removes a skill folder.
  • scripts/scan_and_check.py
    : 核心脚本。扫描目录、解析前置元数据、获取远程标签、返回状态。
  • scripts/update_helper.py
    : (可选) 更新前备份文件的辅助脚本。
  • scripts/list_skills.py
    : 列出所有已安装的Skill及其类型和版本。
  • scripts/delete_skill.py
    : 永久删除Skill文件夹。

Metadata Requirements

元数据要求

This manager relies on the 
github-to-skills
metadata standard:
  • github_url
    : Source of truth.
  • github_hash
    : State of truth.
该管理器依赖
github-to-skills
元数据标准：
  • github_url
    : 数据源基准。
  • github_hash
    : 状态基准。