← Back to Skills Marketplace
612
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install legiscan-bill-search
Description
Search and track active or completed state bills by keywords and state using the LegiScan API with customizable filters.
README (SKILL.md)
LegiScan Bill Tracker\r
\r A skill to monitor state legislative activity using the LegiScan API. It filters for active bills based on custom keywords and state selection.\r \r
Setup\r
\r
- API Key: Obtain a free API key from LegiScan.\r
- Environment Variable: Set
LEGISCAN_API_KEYin your environment.\r - Dependencies: Requires
requests.\r \r
Usage\r
\r Run the script directly or via a scheduled task (cron).\r \r
# Default (TX, cryptocurrency keywords)\r
python3 search.py\r
\r
# Custom State and Keywords\r
python3 search.py --state TX --keywords "crypto, bitcoin, blockchain"\r
\r
# Include passed/completed bills\r
python3 search.py --state TX --keywords "crypto, bitcoin, blockchain" --all\r
```\r
\r
## Configuration Options\r
\r
- `--state`: Two-letter state abbreviation (Default: `TX` or `LEGISCAN_STATE` env var).\r
- `--keywords`: Comma-separated list of terms to search for.\r
- `--all`: If flag is present, includes bills that have passed or are completed.\r
\r
## Best Practices\r
- The script uses environment variables for sensitive credentials.\r
- It provides CLI arguments for flexibility without modifying code.\r
- It includes error handling for API failures and missing configuration.
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: legiscan-bill-search
Version: 1.0.0
The skill bundle is benign. The `search.py` script interacts with the LegiScan API to retrieve legislative bill information, using `requests` for HTTP calls. It securely obtains the API key from the `LEGISCAN_API_KEY` environment variable and does not access any other sensitive files or external domains. The `SKILL.md` documentation is straightforward and contains no prompt injection attempts or instructions for the agent to perform malicious actions. All code and instructions align with the stated purpose of monitoring state legislative activity.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install legiscan-bill-search - After installation, invoke the skill by name or use
/legiscan-bill-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of LegiScan Bill Tracker skill.
- Enables monitoring of state legislative activity via the LegiScan API.
- Filters for active bills based on custom keywords and state selection.
- Supports command-line configuration for state, keywords, and bill status.
- Utilizes environment variables for sensitive data (API key).
- Includes error handling for API issues and missing configuration.
Metadata
Frequently Asked Questions
What is LegiScan Bill Search?
Search and track active or completed state bills by keywords and state using the LegiScan API with customizable filters. It is an AI Agent Skill for Claude Code / OpenClaw, with 612 downloads so far.
How do I install LegiScan Bill Search?
Run "/install legiscan-bill-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is LegiScan Bill Search free?
Yes, LegiScan Bill Search is completely free (open-source). You can download, install and use it at no cost.
Which platforms does LegiScan Bill Search support?
LegiScan Bill Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created LegiScan Bill Search?
It is built and maintained by n4cra (@n4cra); the current version is v1.0.0.
More Skills