URL Toolkit

URL encoding, decoding, parameter parsing, and URL manipulation toolkit for developers.

Security Scan

The skill's code, instructions, and requirements match its stated purpose (URL encode/decode/parse/build); it doesn't request credentials, network access, or perform suspicious actions.

Purpose & Capability

The name/description (URL encoding, decoding, parsing, building) align with the included Python script and the declared requirement of python3. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md only instructs running the included script with arguments. The script operates on the provided input string and returns JSON; it does not read other files, environment variables, or send data externally.

Install Mechanism

There is no install spec (instruction-only). All code is present in the package and uses Python standard library. No downloads, external packages, or archive extraction are performed during install.

Credentials

No environment variables, credentials, or config paths are required. The declared single binary requirement (python3) is appropriate for a Python script.

Persistence & Privilege

The skill is not configured as always: true and does not request persistent system-wide changes or modify other skills' configurations. Autonomous invocation is allowed by default but is appropriate for a small utility.

Assessment

This skill is coherent and appears safe: it only needs python3 and runs a local script that manipulates URL strings. If you plan to install it, confirm you trust the source bundle (the package includes the script in plaintext) and that running arbitrary scripts is acceptable in your environment. If you need IPv6 host parsing or special handling of list values in query-build, review the script logic before use, but there are no red flags for credential access or network exfiltration.

A comprehensive URL manipulation tool for developers.

Features

• Encode - Encode URL (percent encoding)
• Decode - Decode URL
• Parse - Parse URL into components (scheme, host, path, query, etc.)
• Query Parse - Parse query string into key-value pairs
• Query Build - Build query string from key-value pairs

Usage

python3 skills/url-toolkit/scripts/url_toolkit.py <action> [options]

Actions

Action	Description
encode	URL encode a string
decode	URL decode a string
parse	Parse URL into components
query-parse	Parse query string to JSON
query-build	Build query string from JSON

Options

Option	Type	Default	Description
--input	string	-	Input string or URL
--full	bool	false	Full encoding (all chars) vs safe encoding

Examples

# URL encode
python3 skills/url-toolkit/scripts/url_toolkit.py encode --input "hello world"
# Output: {"success": true, "result": "hello%20world"}

# URL decode
python3 skills/url-toolkit/scripts/url_toolkit.py decode --input "hello%20world"
# Output: {"success": true, "result": "hello world"}

# Parse URL
python3 skills/url-toolkit/scripts/url_toolkit.py parse --input "https://example.com:8080/path?q=test&id=123#section"
# Output: {"success": true, "result": {"scheme": "https", "host": "example.com", ...}}

# Parse query string
python3 skills/url-toolkit/scripts/url_toolkit.py query-parse --input "q=test&id=123&name=hello+world"
# Output: {"success": true, "result": {"q": "test", "id": "123", "name": "hello world"}}

# Build query string
python3 skills/url-toolkit/scripts/url_toolkit.py query-build --input '{"q":"test","id":123,"name":"hello world"}'
# Output: {"success": true, "result": "q=test&id=123&name=hello%20world"}

Use Cases

1. API development - Encode/decode URL parameters
2. Web scraping - Parse URLs and extract components
3. Debugging - Inspect query parameters
4. URL building - Construct URLs from components
5. Data processing - Clean and normalize URLs

Current Status

Ready for testing.