mcpField
S
skill-manager

skill-manager

github.com/kkkkhazixAgent workflows21.8k295 installsUpdated 4w ago
Repository

About skill-manager

Skill Lifecycle Manager helps agents maintain local libraries of GitHub-backed skills. It compares local commits with remote HEAD and provides workflows for updates, inventory, and deletion.

Key features

  1. 01Scan skills with GitHub metadata
  2. 02Compare local and remote commit hashes
  3. 03Report skill update status
  4. 04Guide skill updates and refactoring
  5. 05List or delete local skills

Use cases

  1. 01Find skills behind their remote versions
  2. 02Update SKILL.md from a new README
  3. 03Review installed skills and versions
  4. 04Remove an unneeded skill directory

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/kkkkhazix/khazix-skills --skill skill-manager

After installing, type/skill-managerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

scripts/
delete_skill.py
list_skills.py
scan_and_check.py
update_helper.py

Details

From the project README

Skill Lifecycle Manager

This skill helps you maintain your library of GitHub-wrapped skills by automating the detection of updates and assisting in the refactoring process.

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.

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>"

Workflow 1: Check for Updates
  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)..."
Workflow 2: Update a 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).

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.

Metadata Requirements

This manager relies on the github-to-skills metadata standard:

  • github_url: Source of truth.
  • github_hash: State of truth.

Comments

Markdown supported