cmds

name	cmds
description	List all project-local skills, subagents, and reference docs for the jnext repo with one-line descriptions. Use when the user says "what skills do I have", "list commands", "what's available", "what can you do here", or asks to discover the project's .claude/ inventory.

Discover available skills, subagents, and docs

List everything under .claude/ for this project so the user knows what's available.

Steps

Run this in a single Bash call (parse frontmatter description: field with awk; fall back to "(no description)"):

ROOT=/home/jorgegv/src/spectrum/jnext/.claude

emit() {
  local file="$1" name="$2"
  local desc
  desc=$(awk -F': ' '/^description:/{sub(/^description:[[:space:]]*/, "", $0); print; exit}' "$file" 2>/dev/null)
  [ -z "$desc" ] && desc="(no description)"
  printf "  %s — %s\n" "$name" "$desc"
}

echo "## Skills (in .claude/skills/ — auto-invoked when user intent matches)"
for f in "$ROOT"/skills/*/SKILL.md; do
  [ -f "$f" ] || continue
  name=$(basename "$(dirname "$f")")
  emit "$f" "$name"
done

echo ""
echo "## Subagents (in .claude/agents/ — dispatched via Agent tool with subagent_type=NAME)"
for f in "$ROOT"/agents/*.md; do
  [ -f "$f" ] || continue
  name=$(basename "$f" .md)
  emit "$f" "$name"
done

echo ""
echo "## Reference docs (in .claude/docs/ — read for project conventions)"
for f in "$ROOT"/docs/*.md; do
  [ -f "$f" ] || continue
  name=$(basename "$f")
  first_para=$(awk 'NR>1 && NF{print; exit}' "$f" 2>/dev/null | head -c 120)
  [ -z "$first_para" ] && first_para="(see file)"
  printf "  %s — %s\n" "$name" "$first_para"
done

# Note: project no longer has .claude/commands/ — everything is a skill so
# auto-invocation works. The list above is exhaustive.

After printing, briefly note:

• Skills are auto-invoked when your message matches their "Use when..." trigger.
• Subagents are dispatched via the Agent tool when work matches their scope; you don't type them.
• Reference docs are background reading; I open them when relevant.