← Back to Skills Marketplace
Weekend Scout
by
Dmitry Nikolaenya
· GitHub ↗
· v1.0.2
· MIT-0
88
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install weekend-scout
Description
Weekend Scout discovers next-weekend outdoor events, festivals, fairs, and road-trip ideas near the user's city and nearby cities. It builds home-city picks...
Usage Guidance
Before installing or running this skill: 1) Inspect install/install_skill.py to see what it does (does it call pip to install locally, fetch remote code, or run arbitrary shell commands?). 2) Inspect weekend_scout/telegram.py and config.py to confirm Telegram bot token/chat_id storage location and that tokens are not transmitted anywhere except Telegram's API. 3) Review any network calls in the code (WebFetch/WebSearch callers) to ensure they go to expected endpoints and that no hard-coded unusual remote endpoints exist. 4) If you lack confidence, run the installer and the skill in a sandboxed environment or VM and/or audit the code paths that run during bootstrap and send. 5) Be cautious that the SKILL.md explicitly forbids inspecting package source during a normal run — that is a design choice that prevents on-the-fly auditing; treat it as a reason to perform an explicit manual review before granting execution.
Capability Analysis
Type: OpenClaw Skill
Name: weekend-scout
Version: 1.0.2
The 'weekend-scout' skill bundle is a well-engineered tool designed to discover outdoor events and deliver them to Telegram. It consists of a Python CLI package for data management (SQLite caching, GeoNames integration, and Telegram delivery) and platform-specific SKILL.md files that guide AI agents through a multi-phase discovery workflow. The Python code is transparent, uses standard libraries (requests, pyyaml), and includes robust diagnostic logging in 'diagnostics.py' that explicitly redacts sensitive keys like tokens and passwords. The installer script 'install/install_skill.py' handles cross-platform setup and Python environment restrictions (PEP 668) legitimately. No evidence of data exfiltration, malicious execution, or prompt injection was found; the behavior is entirely consistent with the stated purpose of the skill.
Capability Assessment
Purpose & Capability
Name/description (scout local events, prepare a digest, send to Telegram) aligns with the included files and runtime contract: a Python CLI package, caching, discovery (WebSearch/WebFetch), formatting, and a Telegram transport are all present and expected.
Instruction Scope
The SKILL.md explicitly tells the agent not to inspect the package source or call --help during a normal run and to treat bundled references/CLI as authoritative. That restriction reduces in-run transparency and auditing of the installed code. The bootstrap flow will run a bundled installer script (install/install_skill.py) if the installed package version differs, so the runtime instructions cause execution of code from the bundle; you should review that code before permitting installation.
Install Mechanism
There is no registry 'install' spec, but the SKILL.md bootstraps by running the included install/install_skill.py via the local Python interpreter. The installer is bundled (no external URL in the manifest), which avoids arbitrary remote downloads, but executing an included installer still executes code on the host. Inspect install/install_skill.py to confirm it only installs the bundled package locally and does not fetch or run unexpected remote artifacts or perform unrelated system changes.
Credentials
The registry declares no required environment variables or credentials. Telegram credentials are expected to be configured via the package's CLI (python -m weekend_scout config), not via environment variables. That is proportionate to the described functionality, but you should verify where and how those credentials are stored (config file or cache) before use.
Persistence & Privilege
The skill is not marked always:true and is user-invocable. It uses a local cache_dir for persistent SQLite and files; it does not request system-level or other skills' configuration access. Normal persistence behavior (cache, SQLite) is consistent with the stated purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install weekend-scout - After installation, invoke the skill by name or use
/weekend-scout - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Updated the root skill description for clarity and detail about event discovery and Telegram integration.
- No logic or workflow changes; all guardrails, dispatch, and bootstrap instructions remain unchanged.
- This update clarifies user-facing documentation without impacting existing functionality.
v1.0.1
- Switched repository entrypoint SKILL.md to a concise bootstrap and dispatch contract instead of a full workflow summary.
- Clarified that the root skill bootstraps or updates the Python runtime, then dispatches to a bundled platform-specific runtime SKILL.md.
- Detailed guardrails and explicit platform/runtime detection, removing generic and design documentation from SKILL.md.
- Added explicit failure handling instructions for missing dependencies or runtime files.
- Removed the CLAUDE.md file;
v1.0.0
Initial release of Weekend Scout.
- Discover outdoor events, festivals, and fairs happening next weekend near a user's city.
- Ranks top local picks and road-trip options, then prepares a delivery-ready digest.
- Multi-platform support (Telegram, CLAUDE, Codex, OpenClaw) with platform-specific runtime instructions.
- Utilizes a layered caching system for state, persistence, and efficient reruns.
- Includes Python CLI helpers for configuring, logging, session handling, and message formatting.
- Root SKILL.md serves as a platform-neutral entry point and routing guide; use platform-specific SKILL.md files for workflows.
Metadata
Frequently Asked Questions
What is Weekend Scout?
Weekend Scout discovers next-weekend outdoor events, festivals, fairs, and road-trip ideas near the user's city and nearby cities. It builds home-city picks... It is an AI Agent Skill for Claude Code / OpenClaw, with 88 downloads so far.
How do I install Weekend Scout?
Run "/install weekend-scout" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Weekend Scout free?
Yes, Weekend Scout is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Weekend Scout support?
Weekend Scout is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Weekend Scout?
It is built and maintained by Dmitry Nikolaenya (@gooorooox); the current version is v1.0.2.
More Skills