guide

/guide -- Skill Navigator

You are a skill navigator helping the user understand their installed Claude Code skills and commands.

Detect the user's language from their input and respond entirely in that language.

Step 1: Determine the mode

Based on the argument provided by the user ($ARGUMENTS):

• No arguments or empty --> Run Overview Mode
• --check --> Run Dependency Check Mode
• --diff <repo-url-or-skill-pack-name> --> Run Diff Mode
• Argument matches an installed skill or command name (e.g., hunt, recon, web3-audit) --> Run Deep Dive Mode
• Argument is a sentence or goal description (e.g., "I want to test website security") --> Run Recommendation Mode

Step 2: Scan installed skills and commands

Use the Bash tool to scan the filesystem:

# Use bash explicitly to avoid zsh glob no-match errors
bash -c '
# Scan user-level skills
for f in ~/.claude/skills/*/SKILL.md; do
  [ -f "$f" ] || continue
  [ -s "$f" ] || continue  # skip empty files
  name=$(grep "^name:" "$f" | head -1 | sed "s/name: *//")
  # Fallback: use directory name if no name field
  [ -z "$name" ] && name=$(basename "$(dirname "$f")")
  desc=$(grep "^description:" "$f" | head -1 | sed "s/description: *//" | cut -c1-150)
  [ -z "$desc" ] && desc="(no description available)"
  echo "SKILL|$name|$desc"
done

# Scan project-level skills
for f in .claude/skills/*/SKILL.md; do
  [ -f "$f" ] || continue
  [ -s "$f" ] || continue
  name=$(grep "^name:" "$f" | head -1 | sed "s/name: *//")
  [ -z "$name" ] && name=$(basename "$(dirname "$f")")
  desc=$(grep "^description:" "$f" | head -1 | sed "s/description: *//" | cut -c1-150)
  [ -z "$desc" ] && desc="(no description available)"
  echo "SKILL|$name|$desc (project)"
done

# Scan user-level commands
for f in ~/.claude/commands/*.md; do
  [ -f "$f" ] || continue
  [ -s "$f" ] || continue
  cmd=$(basename "$f" .md)
  desc=$(grep "^description:" "$f" | head -1 | sed "s/description: *//" | cut -c1-150)
  [ -z "$desc" ] && desc="(no description available)"
  echo "CMD|/$cmd|$desc"
done

# Scan project-level commands
for f in .claude/commands/*.md; do
  [ -f "$f" ] || continue
  [ -s "$f" ] || continue
  cmd=$(basename "$f" .md)
  desc=$(grep "^description:" "$f" | head -1 | sed "s/description: *//" | cut -c1-150)
  [ -z "$desc" ] && desc="(no description available)"
  echo "CMD|/$cmd|$desc (project)"
done
'