list-repo-skills

Lists skills defined in the current git repository's skill directories.

Updated Dec 18, 2025
One-click install
npx skills add https://github.com/l0lxl0lw/dotfiles --skill list-repo-skills-l0lxl0lw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-repo-skills
Source: https://github.com/l0lxl0lw/dotfiles/tree/main/ai/shared/skills/utilities/list-repo-skills
Command: npx skills add https://github.com/l0lxl0lw/dotfiles --skill list-repo-skills-l0lxl0lw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working across many projects, it is hard to know which skills come from the repository you are in versus the ones installed globally from dotfiles, plugins, or user-level config. This Skill answers that question precisely by scanning only the current checkout. ## Core Features & Use Cases - Repo-scoped discovery: Finds every SKILL.md under the git root's .claude/skills, .agents/skills, .codex/skills, or .grok/skills directories, excluding anything from ~/.claude, dotfiles, or plugins. - Git-root aware: Resolves the repository root automatically, so it works from any subdirectory; outside a git repo it falls back to the working directory and says so. - Optional descriptions: The --desc flag adds a description column when you want to know what each repo skill does. - Use Case: You clone an unfamiliar codebase and ask "what skills does this repo have?" — the Skill prints exactly the skills that ship with that checkout, verbatim, with no global skills mixed in. ## Quick Start Ask the assistant to list the skills defined by the current repository, for example by saying "list repo skills" while inside the project.

Frequently Asked Questions about list-repo-skills

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

FAQPage Schema
How do I list skills defined by a git repository?

Run the list-skills.sh helper with the --repo flag from anywhere inside the repository. It resolves the git root automatically and prints every SKILL.md found under .claude/skills, .agents/skills, .codex/skills, or .grok/skills.

What is the difference between repo skills and global skills?

Repo skills exist because of the current checkout and travel with it, living under the git root's skill directories. Global skills come from ~/.claude, dotfiles, or plugins and are excluded from this listing; use the list-skills skill for the full catalog.

Does listing repo skills work from a subdirectory?

Yes, the script resolves the git root itself, so any subdirectory of the repository works. Outside a git repo it falls back to the current working directory and states that it did so.

What happens when a repository defines no skills?

The script reports that the repo defines no skills, and that is the complete answer. Most repositories define none, so this is a normal result rather than an error, and global skills are not listed as a fallback.

How do I see what each repo skill does?

Pass the --desc flag to the script to add a description column alongside each skill name. Without the flag, the output is a plain list of skill names only.