How do I install the Skill Manager skill?

Run npx skillmds add tools-only/skill-manager in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skill Manager safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skill Manager?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skill Manager free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Skill Manager?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skill Manager by tools-only — Agent Skill

Name: Skill Manager
Rating: 4.5 (4 reviews)
Author: tools-only

File contents

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_url metadata.
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 "

Workflow 1: Check for Updates

Run Scanner: The agent runs scripts/scan_and_check.py to 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.

---name: skill-managerdescription: Lifecycle manager for GitHub-based skills. Use this to batch scan your skills directory, check for updates on GitHub, and perform guided upgrades of your skill wrappers.license: MIT--- # 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.

Frequently asked questions