last30days (open variant): Research + Watchlist + Briefings

Multi-mode research skill with persistent knowledge accumulation.

Command Routing

Parse the user's first argument to determine the mode:

| First word | Mode | Reference | |---|---|---| | watch | Watchlist management | references/watchlist.md | | briefing | Morning briefing | references/briefing.md | | history | Query accumulated knowledge | references/history.md | | (anything else) | One-shot research | references/research.md |

Setup: Find Skill Root

for dir in \
  "." \
  "${CLAUDE_PLUGIN_ROOT:-}" \
  "${GEMINI_EXTENSION_DIR:-}" \
  "$HOME/.gemini/extensions/last30days-skill" \
  "$HOME/.gemini/extensions/last30days" \
  "$HOME/.claude/skills/last30days" \
  "$HOME/.agents/skills/last30days" \
  "$HOME/.codex/skills/last30days"; do
  [ -n "$dir" ] && [ -f "$dir/scripts/last30days.py" ] && SKILL_ROOT="$dir" && break
done

if [ -z "${SKILL_ROOT:-}" ]; then
  echo "ERROR: Could not find scripts/last30days.py" >&2
  exit 1
fi

Use $SKILL_ROOT for all script and reference file paths.

Load Context

At session start, read ${SKILL_ROOT}/variants/open/context.md for user preferences and source quality notes. Update it after interactions.

Shared Configuration

• Database: ~/.local/share/last30days/research.db (SQLite, WAL mode)
• Briefings: ~/.local/share/last30days/briefs/
• API keys: ~/.config/last30days/.env or environment variables
• Key priority: env vars > config file

API Keys

| Key | Required | Purpose | |---|---|---| | OPENAI_API_KEY | For Reddit | Reddit search via OpenAI responses API | | XAI_API_KEY | For X (fallback) | X search via xAI Grok API | | OPENROUTER_API_KEY | Optional | Perplexity Sonar Pro search + AI reasoning (planning/reranking). Add INCLUDE_SOURCES=perplexity to enable. Use --deep-research for exhaustive reports. | | PARALLEL_API_KEY | Optional | Web search via Parallel AI | | BRAVE_API_KEY | Optional | Web search via Brave Search |

Bird CLI provides free X search if installed. YouTube search uses yt-dlp (free).

Run python3 "${SKILL_ROOT}/scripts/last30days.py" --diagnose to check source availability.

Routing Logic

After determining the mode, read the corresponding reference file using the Read tool:

Read: ${SKILL_ROOT}/variants/open/references/{mode}.md

Then follow the instructions in that reference file exactly.