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.

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

01Metadata extraction from SKILL.md YAML frontmatter for context

02Comprehensive mapping of executable script paths for every skill

03Zero-dependency bash implementation for maximum project portability

04Automatic discovery of installed AgenticDev skills and capabilities

05Support for both human-readable and machine-readable JSON output

069 GitHub stars

Use Cases

01Bootstrapping an AI work session to identify available automation tools

02Auditing and verifying the installation of specific AgenticDev capabilities

03Onboarding developers or agents to a new repository with custom workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bodangren/git-workflow skill-lister

For use in Claude.ai and ChatGPT

Download Skill