Files
game-kit/.claude/skills/gamehall-visitors/SKILL.md
T
Eric WagonerandClaude Opus 5.5 1dbf5763e1 The hall counts its visitors: a digest, a nightly rollup, and the games it sends people to
gamehall/ops holds the traffic counter, the visitors digest and the
nightly rollup, installed by gamehall/deploy.sh; the gamehall-visitors
skill reads them. The hall now sends its origin as referrer, so a game
can tell who came from it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jm2auWk6RP71CjaAb4FMoG
2026-09-26 12:41:55 -04:00

1.7 KiB

name, description
name description
gamehall-visitors Who is visiting Kestrel's Hall, the landing page at gamehall.kestrelsnest.social - the last hour, today, where they came from, how many went on into each game, and the week's trend. Use when Eric asks about hall traffic or visitors.

Kestrel's Hall visitors

One command on the shared host prints the digest:

ssh root@159.203.115.252 /usr/local/bin/gamehall-visitors.sh [YYYY-MM-DD]

Default is today, UTC. It reads Caddy's access log for the hall's own name (the sslip test address is left out) and prints:

  • last hour (today only): people and page views, the "right now".
  • today: people (distinct addresses), page views, bot addresses.
  • referrers and campaigns: the sites that sent people, and the tags links carry (?ref=, utm_source, Facebook's fbclid). Reddit and some apps send no referrer.
  • went on to: people each game on this host (Dip, Waving Hands, Hnefatafl) received with the hall as referrer. The hall sends its origin as referrer, nothing more. Wiz-War is on its own droplet; its own digest (/wizwar-visitors) lists gamehall.kestrelsnest.social among its referrers.
  • last 7 days from /var/lib/gamehall/rollup.jsonl, written nightly at 00:05 UTC by gamehall-rollup.sh for the day before (counts only, no addresses).

Read it

Lead with whether anyone is here now and today's people, then where they came from, then how many went on into a game (the hall's job is to send people to tables). Give the week's direction from the rollup in one sentence. Eric's own devices count as people; a handful on a quiet day may be him.

The source is gamehall/ops/ in game-kit; gamehall/deploy.sh installs it on every publish.