LegiScan Bill Search

Search and track active or completed state bills by keywords and state using the LegiScan API with customizable filters.

Security Scan

The skill's code and SKILL.md ask for a LegiScan API key and only call LegiScan endpoints (which matches the stated purpose), but the registry metadata does not declare the required environment variable—an incoherence that should be clarified before trusting or installing the skill.

Purpose & Capability

The name/description (search and track state bills via LegiScan) matches what the code does: it queries LegiScan search and bill endpoints and summarizes results. The required dependency (requests) and the CLI flags are appropriate for this purpose. However, the registry metadata lists no required environment variables even though the SKILL.md and code require LEGISCAN_API_KEY (and optionally LEGISCAN_STATE), which is inconsistent.

Instruction Scope

SKILL.md instructs the agent/user to set LEGISCAN_API_KEY, install requests, and run the script or schedule it. The script only performs HTTP GETs to api.legiscan.com and reads only the declared environment variables/CLI args; it does not read arbitrary files, other env vars, or talk to third-party endpoints. Instruction scope stays within the stated purpose.

Install Mechanism

There is no install spec (lowest install risk). The package is delivered as an included Python script; the only runtime dependency is the widely used requests library mentioned in SKILL.md. No downloaded archives or external installers are present.

Credentials

The code and SKILL.md require a LEGISCAN_API_KEY (and optionally LEGISCAN_STATE), which is proportionate to the function. However, the registry metadata incorrectly lists no required env vars or primary credential—this mismatch could cause confusion or hide that the skill needs a credential. That discrepancy is the main proportionality concern.

Persistence & Privilege

The skill does not request persistent or elevated privileges. always:false and no install hooks or config writes are present. It does not modify other skills or system-wide settings.

What to consider before installing

This skill appears to do only what it claims (query LegiScan and summarize bills), but the package metadata failing to declare the required LEGISCAN_API_KEY is a red flag for sloppy packaging and possible future surprises. Before installing: (1) confirm the skill owner/source (homepage is missing); (2) ensure you will provide a dedicated LegiScan API key (do not reuse high-privilege or shared keys); (3) review the included search.py (you already have it) for any edits or hidden behavior; (4) run it in a limited environment (or inside a container/VM) if you are unsure; and (5) ask the publisher to correct the registry metadata to declare LEGISCAN_API_KEY (and any other required env vars). If the metadata is corrected and the code remains unchanged, the skill is coherent and low-risk for its stated purpose.

LegiScan Bill Tracker

A skill to monitor state legislative activity using the LegiScan API. It filters for active bills based on custom keywords and state selection.

Setup

1. API Key: Obtain a free API key from LegiScan.
2. Environment Variable: Set LEGISCAN_API_KEY in your environment.
3. Dependencies: Requires requests.

Usage

Run the script directly or via a scheduled task (cron).

# Default (TX, cryptocurrency keywords)
python3 search.py

# Custom State and Keywords
python3 search.py --state TX --keywords "crypto, bitcoin, blockchain"

# Include passed/completed bills
python3 search.py --state TX --keywords "crypto, bitcoin, blockchain" --all

Configuration Options

• --state: Two-letter state abbreviation (Default: TX or LEGISCAN_STATE env var).
• --keywords: Comma-separated list of terms to search for.
• --all: If flag is present, includes bills that have passed or are completed.

Best Practices

• The script uses environment variables for sensitive credentials.
• It provides CLI arguments for flexibility without modifying code.
• It includes error handling for API failures and missing configuration.