Source Code

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

clawdhub-contributor