clawdhub-contributor

ClawdHub Contributor

Adds contribution capabilities to your agent. Help grow the ClawdHub ecosystem by analyzing skills, reporting bugs, and sharing useful skill combinations.

Modes

Mode	What it does
passive	Bug reports and recipes only (safe default)
active	Adds auto-scout: analyze unknown skills locally and generate reports
full	All above plus opt-in telemetry

Set mode in config/default.json or via CLAWDHUB_CONTRIB_MODE env var.

Features

Auto-Scout (active/full mode)

Analyze a local skill directory and produce a structured quality/security report:

bash scripts/scout.sh /path/to/skill-directory

Output: JSON report with dependency info, quality score, and security flags. Fully offline — no network access, pure static analysis.

Bug Reporting (all modes)

Report a skill failure with sanitized system context:

bash scripts/report-bug.sh <skill-slug> <error-message> [context]

Output: JSON bug report ready for API submission. Collects OS and node version but never leaks hostname, IP, or username.

Recipes (all modes)

Share a useful combination of skills that solved a task:

bash scripts/submit-recipe.sh <task-description> <skill1> [skill2] [skill3] ...

Output: JSON recipe ready for API submission.

Configuration

Edit config/default.json:

{
  "mode": "passive",
  "telemetry": false,
  "autoScout": false,
  "bugReports": true,
  "recipes": true
}

Key	Type	Description
mode	string	passive, active, or full
telemetry	bool	Opt-in anonymous usage stats (full mode only)
autoScout	bool	Auto-scan skills on encounter (active/full mode)
bugReports	bool	Enable bug report generation
recipes	bool	Enable recipe submission

Commands Summary

Command	Mode Required	Description
scripts/scout.sh <dir>	active+	Analyze a skill directory
scripts/report-bug.sh <slug> <msg> [ctx]	any	Generate bug report
scripts/submit-recipe.sh <task> <skills...>	any	Generate recipe

Security

• Scripts never access the network
• No credentials, IPs, hostnames, or usernames are collected
• All output is sanitized JSON to stdout
• Scout performs read-only static analysis