skill-manager_skill

Overview

This skill is a lifecycle manager for GitHub-based skills that automates scanning, status reporting, and guided upgrades. It helps keep a local skills directory synchronized with remote sources and streamlines safe refactoring of skill wrappers. Designed for batch operations, it supports auditing, updating, listing, and deletion workflows.

How this skill works

The manager scans the local skills folder for entries that include GitHub metadata and uses remote queries to compare local commit hashes with the latest remote head. It produces a concise status report marking skills as current or stale and provides a guided update flow that fetches remote documentation, performs a diff against local documentation, and applies controlled changes to metadata and wrapper code. Optional helper scripts back up files and validate changes after update.

When to use it

• Periodically scan your skills collection to detect outdated wrappers
• Before running or deploying agents that depend on third-party skill code
• When you want a guided, repeatable process to update skill metadata and wrappers
• To audit and produce an inventory of installed skills and versions
• Before removing a skill to ensure safe cleanup and backups

Best practices

• Keep each skill annotated with github_url and github_hash metadata so the manager can track state
• Run the scanner in CI or scheduled jobs to catch drift early
• Review generated status reports before automated updates to avoid unintended API or CLI changes
• Use the update helper to create backups before refactoring wrapper code
• Validate updated wrappers with quick integration checks when available

Example use cases

• Run a periodic scan to list skills that are behind upstream by N commits and schedule updates
• Perform a guided update for a specific skill: fetch remote docs, detect changes, update metadata, and adjust the wrapper
• Generate an inventory report for compliance or debugging teams showing installed skills and their remote state
• Delete deprecated or unused skills safely with backup and cleanup scripts