docs: update repository guidelines and improve formatting across multiple files

- Enhanced AGENTS.md with clearer project structure and development commands.
- Updated CHANGELOG.md to reflect recent fixes and additions.
- Improved formatting in CONTRIBUTING.md for better readability.
- Adjusted package.json and configuration files for consistent command structure.
- Refined README.md and VISION.md for clarity and organization.
- Standardized code formatting in various TypeScript files for consistency.

These changes aim to enhance documentation clarity and maintainability across the repository.

2026-03-18 21:56:01 -05:00

1.3 KiB

Raw Permalink Blame History

summary

read_when

Discord webhook events/payloads for skill publish + highlight.

Working on webhooks/integrations

Webhooks (Discord)

ClawHub can post Discord embeds when skills are published or highlighted.

Setup

Set the webhook URL in the Convex environment:

DISCORD_WEBHOOK_URL (required): Discord webhook URL.
DISCORD_WEBHOOK_HIGHLIGHTED_ONLY (optional): true to only send for highlighted skills.
SITE_URL (optional): Base site URL for links (default https://clawhub.ai).

Events

skill.publish: fires on every publish (new or updated version).
skill.highlighted: fires when a skill is newly highlighted.

Highlight-only filter

When DISCORD_WEBHOOK_HIGHLIGHTED_ONLY=true:

skill.publish only sends if the skill is highlighted.
skill.highlighted always sends.

Payload (Discord)

Discord receives a JSON payload with a single embed:

{
  "embeds": [
    {
      "title": "Demo Skill",
      "description": "Nice skill",
      "url": "https://clawhub.ai/owner/demo-skill",
      "fields": [
        { "name": "Version", "value": "v1.2.3", "inline": true },
        { "name": "Owner", "value": "@owner", "inline": true },
        { "name": "Tags", "value": "latest, discord", "inline": false }
      ],
      "footer": { "text": "ClawHub" }
    }
  ]
}

1.3 KiB Raw Permalink Blame History