/skills
List golem skills/descriptions/grades/status. Triggers: list/search/show skills. NOT invoking skills.
$ golems-cli skills install skillsUpdated today
List and search your installed Claude Code skills.
Usage
When invoked via /skills, scan and display all available skills. If the user provides arguments like --search <keyword>, filter accordingly.
Instructions
Step 1: Scan Skills Directory
Run this to discover all skills:
#!/bin/bash
SKILLS_DIR="$HOME/.claude/commands"
echo "# Installed Skills"
echo ""
# Arrays to hold skills by category
declare -a domain_skills
declare -a infra_skills
declare -a custom_skills
# Function to extract description from a file
extract_desc() {
local file="$1"
# First try YAML frontmatter description
if head -1 "$file" | grep -q '^---$'; then
desc=$(awk '/^---$/{p++} p==1 && /^description:/{gsub(/^description: */, ""); print; exit}' "$file")
if [[ -n "$desc" ]]; then
echo "$desc"
return
fi
fi
# Fall back to first # header blockquote
desc=$(awk '/^#/{found=1} found && /^>/{gsub(/^> */, ""); print; exit}' "$file")
if [[ -n "$desc" ]]; then
echo "$desc"
return
fi
# Final fallback: first non-empty line after header
awk '/^#/{found=1; next} found && NF{print; exit}' "$file"
}
# Function to count workflows in a directory
count_workflows() {
local dir="$1"
if [[ -d "$dir/workflows" ]]; then
find "$dir/workflows" -name "*.md" 2>/dev/null | wc -l | tr -d ' '
else
echo "0"
fi
}
# Function to determine source of a skill
get_source() {
local path="$1"
local resolved=$(readlink -f "$path" 2>/dev/null || echo "$path")
if [[ "$resolved" == *"/golem-powers/"* ]] || [[ "$resolved" == *"/golems/skills/"* ]]; then
echo "golem-powers"
elif [[ "$resolved" == *"/superpowers/"* ]]; then
echo "superpowers"
elif [[ "$resolved" == *"/golems/"* ]] || [[ "$resolved" == *"/.config/golems/"* ]]; then
echo "golem-powers"
else
echo "custom"
fi
}
# Function to categorize skill
categorize_skill() {
local name="$1"
local desc="$2"
# Infrastructure skills
if echo "$name $desc" | grep -qiE 'git|github|commit|push|pr|1password|secret|vault|credential'; then
echo "infra"
# Domain skills (browser, PRD, etc)
elif echo "$name $desc" | grep -qiE 'brave|browser|prd|product|archive|critique'; then
echo "domain"
else
echo "custom"
fi
}
# Scan for skills (handles namespaced skills like golem-powers/)
scan_skill_dir() {
local dir="$1"
local namespace="$2"
for item in "$dir"/*; do
[[ ! -e "$item" ]] && continue
local name=$(basename "$item" .md)
# Skip meta items
[[ "$name" == "skills" ]] && continue
if [[ -d "$item" ]]; then
# Check if this is a skill directory (has SKILL.md)
if [[ -f "$item/SKILL.md" ]]; then
local full_name="${namespace}${name}"
local desc=$(extract_desc "$item/SKILL.md")
local workflows=$(count_workflows "$item")
local source=$(get_source "$item")
local category=$(categorize_skill "$name" "$desc")
local entry="$full_name|$desc|$source|$workflows"
case $category in
infra) infra_skills+=("$entry") ;;
domain) domain_skills+=("$entry") ;;
*) custom_skills+=("$entry") ;;
esac
else
# This is a namespace directory (like golem-powers/), recurse
scan_skill_dir "$item" "${name}:"
fi
elif [[ -f "$item" && "$item" == *.md ]]; then
# Single-file skill
local full_name="${namespace}${name}"
local desc=$(extract_desc "$item")
local source=$(get_source "$item")
local category=$(categorize_skill "$name" "$desc")
local entry="$full_name|$desc|$source|0"
case $category in
infra) infra_skills+=("$entry") ;;
domain) domain_skills+=("$entry") ;;
*) custom_skills+=("$entry") ;;
esac
fi
done
}
# Start scanning from the root commands directory
scan_skill_dir "$SKILLS_DIR" ""
# Print function
print_skills() {
local title="$1"
shift
local skills=("$@")
if [[ ${#skills[@]} -gt 0 ]]; then
echo "## $title"
echo ""
echo "| Skill | Description | Source | Workflows |"
echo "|-------|-------------|--------|-----------|"
for skill in "${skills[@]}"; do
IFS='|' read -r name desc source workflows <<< "$skill"
if [[ "$workflows" -gt 0 ]]; then
echo "| **$name** | $desc | $source | $workflows |"
else
echo "| **$name** | $desc | $source | - |"
fi
done
echo ""
fi
}
# Output grouped by category
print_skills "Infrastructure" "${infra_skills[@]}"
print_skills "Domain" "${domain_skills[@]}"
print_skills "Custom" "${custom_skills[@]}"
echo "---"
echo "*Use \`/skills --search <keyword>\` to filter skills*"Step 2: Handle Search Filter
If the user invoked /skills --search <keyword>, modify the output to filter:
SEARCH="$1" # e.g., "git" or "browser"
# In the scan loop, add filtering:
if [[ -n "$SEARCH" ]]; then
if ! echo "$name $desc" | grep -qi "$SEARCH"; then
continue # Skip non-matching skills
fi
fiStep 3: Present Results
After running the discovery script, present the results in a clean markdown table grouped by category:
- Infrastructure - git, github, secrets, credentials
- Domain - browser, PRD, specific tools
- Custom - user-created skills
For each skill, show:
- Name: The skill command (e.g.,
/pr-loop) - Description: From frontmatter or first paragraph
- Source: Where it comes from (golem-powers, superpowers, custom)
- Workflows: Count of sub-workflows for progressive disclosure skills
Example Output
# Installed Skills
Full SKILL.md source — includes LLM directives, anti-patterns, and technical instructions stripped from the Overview tab.
List and search your installed Claude Code skills.
Usage
When invoked via /skills, scan and display all available skills. If the user provides arguments like --search <keyword>, filter accordingly.
Instructions
Step 1: Scan Skills Directory
Run this to discover all skills:
#!/bin/bash
SKILLS_DIR="$HOME/.claude/commands"
echo "# Installed Skills"
echo ""
# Arrays to hold skills by category
declare -a domain_skills
declare -a infra_skills
declare -a custom_skills
# Function to extract description from a file
extract_desc() {
local file="$1"
# First try YAML frontmatter description
if head -1 "$file" | grep -q '^---$'; then
desc=$(awk '/^---$/{p++} p==1 && /^description:/{gsub(/^description: */, ""); print; exit}' "$file")
if [[ -n "$desc" ]]; then
echo "$desc"
return
fi
fi
# Fall back to first # header blockquote
desc=$(awk '/^#/{found=1} found && /^>/{gsub(/^> */, ""); print; exit}' "$file")
if [[ -n "$desc" ]]; then
echo "$desc"
return
fi
# Final fallback: first non-empty line after header
awk '/^#/{found=1; next} found && NF{print; exit}' "$file"
}
# Function to count workflows in a directory
count_workflows() {
local dir="$1"
if [[ -d "$dir/workflows" ]]; then
find "$dir/workflows" -name "*.md" 2>/dev/null | wc -l | tr -d ' '
else
echo "0"
fi
}
# Function to determine source of a skill
get_source() {
local path="$1"
local resolved=$(readlink -f "$path" 2>/dev/null || echo "$path")
if [[ "$resolved" == *"/golem-powers/"* ]] || [[ "$resolved" == *"/golems/skills/"* ]]; then
echo "golem-powers"
elif [[ "$resolved" == *"/superpowers/"* ]]; then
echo "superpowers"
elif [[ "$resolved" == *"/golems/"* ]] || [[ "$resolved" == *"/.config/golems/"* ]]; then
echo "golem-powers"
else
echo "custom"
fi
}
# Function to categorize skill
categorize_skill() {
local name="$1"
local desc="$2"
# Infrastructure skills
if echo "$name $desc" | grep -qiE 'git|github|commit|push|pr|1password|secret|vault|credential'; then
echo "infra"
# Domain skills (browser, PRD, etc)
elif echo "$name $desc" | grep -qiE 'brave|browser|prd|product|archive|critique'; then
echo "domain"
else
echo "custom"
fi
}
# Scan for skills (handles namespaced skills like golem-powers/)
scan_skill_dir() {
local dir="$1"
local namespace="$2"
for item in "$dir"/*; do
[[ ! -e "$item" ]] && continue
local name=$(basename "$item" .md)
# Skip meta items
[[ "$name" == "skills" ]] && continue
if [[ -d "$item" ]]; then
# Check if this is a skill directory (has SKILL.md)
if [[ -f "$item/SKILL.md" ]]; then
local full_name="${namespace}${name}"
local desc=$(extract_desc "$item/SKILL.md")
local workflows=$(count_workflows "$item")
local source=$(get_source "$item")
local category=$(categorize_skill "$name" "$desc")
local entry="$full_name|$desc|$source|$workflows"
case $category in
infra) infra_skills+=("$entry") ;;
domain) domain_skills+=("$entry") ;;
*) custom_skills+=("$entry") ;;
esac
else
# This is a namespace directory (like golem-powers/), recurse
scan_skill_dir "$item" "${name}:"
fi
elif [[ -f "$item" && "$item" == *.md ]]; then
# Single-file skill
local full_name="${namespace}${name}"
local desc=$(extract_desc "$item")
local source=$(get_source "$item")
local category=$(categorize_skill "$name" "$desc")
local entry="$full_name|$desc|$source|0"
case $category in
infra) infra_skills+=("$entry") ;;
domain) domain_skills+=("$entry") ;;
*) custom_skills+=("$entry") ;;
esac
fi
done
}
# Start scanning from the root commands directory
scan_skill_dir "$SKILLS_DIR" ""
# Print function
print_skills() {
local title="$1"
shift
local skills=("$@")
if [[ ${#skills[@]} -gt 0 ]]; then
echo "## $title"
echo ""
echo "| Skill | Description | Source | Workflows |"
echo "|-------|-------------|--------|-----------|"
for skill in "${skills[@]}"; do
IFS='|' read -r name desc source workflows <<< "$skill"
if [[ "$workflows" -gt 0 ]]; then
echo "| **$name** | $desc | $source | $workflows |"
else
echo "| **$name** | $desc | $source | - |"
fi
done
echo ""
fi
}
# Output grouped by category
print_skills "Infrastructure" "${infra_skills[@]}"
print_skills "Domain" "${domain_skills[@]}"
print_skills "Custom" "${custom_skills[@]}"
echo "---"
echo "*Use \`/skills --search <keyword>\` to filter skills*"Step 2: Handle Search Filter
If the user invoked /skills --search <keyword>, modify the output to filter:
SEARCH="$1" # e.g., "git" or "browser"
# In the scan loop, add filtering:
if [[ -n "$SEARCH" ]]; then
if ! echo "$name $desc" | grep -qi "$SEARCH"; then
continue # Skip non-matching skills
fi
fiStep 3: Present Results
After running the discovery script, present the results in a clean markdown table grouped by category:
- Infrastructure - git, github, secrets, credentials
- Domain - browser, PRD, specific tools
- Custom - user-created skills
For each skill, show:
- Name: The skill command (e.g.,
/pr-loop) - Description: From frontmatter or first paragraph
- Source: Where it comes from (golem-powers, superpowers, custom)
- Workflows: Count of sub-workflows for progressive disclosure skills
Example Output
# Installed Skills
## Infrastructure
| Skill | Description | Source | Workflows |
|-------|-------------|--------|-----------|
| **github** | Git and GitHub CLI operations | golem-powers | 4 |
| **1password** | Secret management with 1Password | golem-powers | 5 |
## Domain
| Skill | Description | Source | Workflows |
|-------|-------------|--------|-----------|
| **brave** | Browser automation via brave-manager | golem-powers | - |
| **prd** | Generate Product Requirements Documents | golem-powers | - |
| **archive** | Archive completed PRD stories | golem-powers | - |
---
*Use `/skills --search <keyword>` to filter skills*
Quick Reference
/skills- List all installed skills/skills --search git- Find skills related to git/skills --search secret- Find skills for secrets management
Best Pass Rate
92%
Opus 4.6
Assertions
12
6 models tested
Avg Cost / Run
$0.1861
across models
Fastest (p50)
3.3s
Gemini 2.5
Behavior Evals
Phase 2 baseline — skill quality on ClaudeBehavior Baseline
Adapter Evals
Phase 2C — cross-AI portabilityAdapter Portability
| Assertion | Opus 4.6 | Sonnet 4.6 | Haiku 4.5 | Codex | Gemini 2.5 | Cursor | Consensus |
|---|---|---|---|---|---|---|---|
| scans-commands-directory | 6/6 | ||||||
| groups-by-category | 4/6 | ||||||
| shows-description-not-content | 5/6 | ||||||
| includes-source-column | 5/6 | ||||||
| includes-workflow-count | 6/6 | ||||||
| includes-superpowers | 4/6 | ||||||
| filters-by-keyword | 6/6 | ||||||
| maintains-table-format | 5/6 | ||||||
| case-insensitive-search | 5/6 | ||||||
| does-not-dump-full-contents | 4/6 | ||||||
| suggests-direct-invocation | 5/6 | ||||||
| still-shows-table | 5/6 |
Token Usage
Cost per Run
| Model | Input Tokens | Output Tokens | Cost / Run | Cost / 1K Runs |
|---|---|---|---|---|
| Opus 4.6 | 9,632 | 10,180 | $0.9080 | $908.00 |
| Sonnet 4.6 | 4,433 | 4,268 | $0.0773 | $77.30 |
| Haiku 4.5 | 2,372 | 2,082 | $0.0032 | $3.20 |
| Codex | 2,738 | 2,437 | $0.0624 | $62.40 |
| Gemini 2.5 | 3,377 | 2,719 | $0.0356 | $35.60 |
| Cursor | 1,999 | 1,371 | $0.0299 | $29.90 |
Response Time (p50)
Response Time (p95)
| Model | p50 | p95 | Overhead |
|---|---|---|---|
| Opus 4.6 | 5.6s | 10.0s | +80% |
| Sonnet 4.6 | 5.0s | 8.5s | +70% |
| Haiku 4.5 | 4.0s | 6.2s | +58% |
| Codex | 7.2s | 13.6s | +88% |
| Gemini 2.5 | 3.3s | 5.4s | +60% |
| Cursor | 4.6s | 9.1s | +98% |
Last evaluated: 2026-03-12 · Data is generated from skill assertions (real cross-model benchmarks coming soon)
Changelog entries are derived from eval runs and skill version updates. Full cascading changelog (Phase 4D) coming soon.
Best Pass Rate
92%
Assertions
12
Models Tested
6
Evals Run
3
- +Initial release to Golems skill library
- +12 assertions across 3 eval scenarios