addyosmani / agent-skills

The session-start script (hooks/session-start.sh) injects the using-agent-skills meta-skill when wired into a host's SessionStart hook. The Claude Code plugin does not register it — Claude Code routes skills natively, and always-on injection would create two routers for the same task (see docs/getting-started.md); the script remains for hosts without native skill routing. A regression test at hooks/session-start-test.sh validates the script's JSON payload — both when jq is available and when it isn't.

Run it before opening any PR that touches:

• hooks/session-start.sh
• skills/using-agent-skills/SKILL.md (the meta-skill content embedded by the hook)

bash hooks/session-start-test.sh

Expected output: session-start JSON payload OK. The script exits non-zero on any assertion failure.

Reproducing the no-jq fallback

The hook still emits the same hookSpecificOutput envelope when jq isn't on PATH, with additionalContext explaining that jq is required. To exercise that branch locally, strip jq's directory from PATH for the test invocation:

JQ_DIR=$(dirname "$(command -v jq)")
PATH=$(echo "$PATH" | tr ':' '\n' | grep -v "^${JQ_DIR}$" | tr '\n' ':' | sed 's/:$//') \
  bash hooks/session-start-test.sh

This works cleanly when jq lives in its own directory (e.g. /opt/homebrew/bin from Homebrew, /usr/local/bin from a manual install). If your jq shares a system bin with other tools the test depends on (such as mktemp in /usr/bin), the simpler approach is to install jq via a separate package manager so it has its own bin directory, then re-run.