How does Skill Lister find new skills?

It automatically scans the .claude/skills/ directory for any subfolders containing a SKILL.md file with standard YAML frontmatter.

Can I use the output programmatically?

Yes, by using the -j flag, the script generates a JSON output ideal for ingestion by other AI tools, custom scripts, or agent integrators.

Is Skill Lister safe to run in any environment?

Yes, it is a lightweight, read-only bash script that performs no modifications to your files or repository state.

What if a skill directory is missing a SKILL.md file?

The script will still identify the directory but may list it without metadata. For best results, ensure all skills follow the SKILL.md convention.

Skill Lister

Name: Skill Lister
Author: bodangren

bybodangren

•

Productivity & Workflow

Discovers and lists all available AgenticDev skills within a project to provide immediate bootstrap context for AI agents.

About

The Skill Lister acts as a discovery engine for the AgenticDev ecosystem, scanning the project's .claude/skills/ directory to extract metadata from SKILL.md files. It provides a comprehensive overview of available capabilities, script paths, and usage instructions, allowing Claude and other AI agents to immediately understand the tools at their disposal without manual file exploration. This bootstrap capability is essential for efficient onboarding, documentation auditing, and ensuring that complex workflows are correctly configured and accessible within the environment.

Key Features

Metadata extraction from SKILL.md YAML frontmatter for context
Comprehensive mapping of executable script paths for every skill
Zero-dependency bash implementation for maximum project portability
Automatic discovery of installed AgenticDev skills and capabilities
Support for both human-readable and machine-readable JSON output
9 GitHub stars

Use Cases

Bootstrapping an AI work session to identify available automation tools
Auditing and verifying the installation of specific AgenticDev capabilities
Onboarding developers or agents to a new repository with custom workflows

About

Key Features

Metadata extraction from SKILL.md YAML frontmatter for context
Comprehensive mapping of executable script paths for every skill
Zero-dependency bash implementation for maximum project portability
Automatic discovery of installed AgenticDev skills and capabilities
Support for both human-readable and machine-readable JSON output
9 GitHub stars

Use Cases

Bootstrapping an AI work session to identify available automation tools
Auditing and verifying the installation of specific AgenticDev capabilities
Onboarding developers or agents to a new repository with custom workflows