sg-student-event-radar
Discover, verify, score, deduplicate, and maintain a personalized queue of Singapore events for international students across any user-chosen industry or field. Use when a Singapore student wants recu
SKILL.mdSKILL.md
GitHubSG Student Event Radar
Keep reusable rules public and every user's profile, choices, database identifiers, and reports under ignored paths.
First use
- Run
python3 scripts/init_local_state.py. - Read references/onboarding.md.
- If
local/config.jsonhasonboarding_complete: false, interview the user or runpython3 scripts/configure_profile.pyinteractively. - Run
python3 scripts/validate_config.py. Do not scan until it passes. - Offer Notion, but never require it. Local Markdown and JSON are the fallback.
Every scan
- Read routine-prompt.md completely and follow it as authoritative.
- Read private config and ledger state.
- If Notion is connected, read user choices before discovery.
- Generate source queries from the configured industries, fields, roles, companies, skills, goals, and exclusions. Do not silently substitute technology interests.
- Deduplicate listing URLs before detail fetches.
- Verify material facts, apply hard gates, score, and keep only qualified events.
- Write at most the configured number of undecided events to the five-minute queue.
- Preserve user choices and make external actions only after action-time confirmation.
Non-negotiable rules
- Prefer direct organiser or registration evidence; label missing facts
needs_verification. - Distinguish
success_zerofrom a failed source and report partial runs loudly. - Never lower the score threshold to fill the queue.
- Never register, pay, message, invite, add calendar entries, or submit forms without confirmation.
- Never bypass login walls or collect personal attendee data.
- Never stage, commit, expose, or quote private runtime state.
Read detailed references only when relevant:
- onboarding.md for first-run questions and profile generation.
- source-strategy.md for dynamic source discovery and evidence rules.
- scoring-rubric.md for gates, scoring, and student-stage examples.
- notion-schema.md only when Notion is requested or already connected.
Run python3 scripts/check_public_release.py before publishing.