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
- Audit: Scans your local skills folder for skills with
github_urlmetadata. - Check: Queries GitHub (via
git ls-remote) to compare local commit hashes against the latest remote HEAD. - Report: Generates a status report identifying which skills are "Stale" or "Current".
- Update Workflow: Provides a structured process for the Agent to upgrade a skill.
- 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
- Run Scanner: The agent runs
scripts/scan_and_check.pyto analyze all skills. - 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)
- Fetch New Context: The agent fetches the *new* README from the remote repo.
- Diff Analysis:
- The agent compares the new README with the old SKILL.md. - Identifies new features, deprecated flags, or usage changes.
- 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.
- 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.