skill-manager

Scan directories to discover and validate Skill Units with SKILL.md metadata.

71|18|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/Science-Discovery/Aether --skill skill-manager-science-discovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-manager
Source: https://github.com/Science-Discovery/Aether/tree/main/.opencode/skills/skill-manager
Command: npx skills add https://github.com/Science-Discovery/Aether --skill skill-manager-science-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a centralized capability to scan a directory of AgentSkills, validate structure, and surface governance metadata to support maintenance and discovery.

Core Features & Use Cases

  • Scan directories to discover all Skill Units (each with SKILL.md) and validate structure.
  • Classify skills by functional domain and generate domain-aware inventories.
  • Analyze cross-skill references and dependencies to map relationships.
  • Generate comprehensive Markdown reports and smart recommendations for improvements.
  • Use cases include auditing large skill collections, merging duplicates, and building skill catalogs for teams.

Quick Start

Run skill-manager to scan a skills directory and produce an initial inventory report.

Frequently Asked Questions about skill-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scan directories to discover and validate skill units?

To scan directories and validate skills, you run the tool to read SKILL.md frontmatter and detect optional resources like scripts. It validates the structure of each skill unit and outputs structured metadata for your inventory.

How do I analyze dependencies and cross-skill references in a large collection?

Analyzing dependencies involves applying cross-skill reference analysis to map relationships across your collection. The tool reads frontmatter to detect dependencies and generates a comprehensive report mapping these relationships.

Can I generate a domain-aware classification report for a skill catalog?

Yes, you can classify skills by functional domain to generate domain-aware inventories. The tool scans your directory, applies classification logic, and produces a comprehensive Markdown report with smart recommendations for catalog building.

Do I need yaml to manage and audit skills at scale?

Yes, yaml is a required dependency to manage skills at scale. The tool relies on it to parse SKILL.md frontmatter, enabling the extraction of governance metadata needed for auditing and maintenance.

What's the best way to merge duplicate skills during an audit?

The best way to merge duplicates is to scan the directory to produce a structured inventory with dependency analysis. This comprehensive report surfaces cross-skill references and provides smart recommendations for identifying and consolidating duplicates.

Why does my skill scan not detect optional scripts or assets?

A skill scan might miss optional scripts or assets if the directory structure is invalid or frontmatter is malformed. The tool validates structure against expected formats, so ensure your SKILL.md and resource paths align with validation rules.