flingjie/skills/list-project-skills

List Project Skills

Purpose

Produce a clean list of the skills defined in the current project — one line per skill, showing its name and description.

Scope is strictly project-local. Global and plugin skills are out of scope.

Scope Boundary

Only scan project-local directories. Never scan the user's home skill directory or plugin directories — that is what keeps the list limited to the current project.

.claude/skills may be a symlink to skills/ (as in this repo). Deduplicate by real path so each skill appears exactly once.

How to Run

From the project root:

python3 scripts/list-project-skills.py

Output

Sorted alphabetically by name. One line per skill:

challenger-selling     Move a complex B2B/SaaS/AI sales opportunity ...
daily-review           Guide a fast (5–10 minute) end-of-day reflection ...
list-project-skills    List the skills defined in the current project only ...
 
14 project skill(s) — global/plugin skills excluded.

Notes

• Read the name from frontmatter; fall back to the directory name if absent.
• Descriptions use a folded > YAML scalar — unfold it to a single line.
• If no project skills exist, say so. Do not fall back to listing global skills.