From 3c3bbaca1baee730c5493dd98aa7b8da88c5abfe Mon Sep 17 00:00:00 2001 From: necatiozmen Date: Tue, 10 Mar 2026 13:12:51 +0300 Subject: [PATCH] update contribution guide --- .github/workflows/pr-check.yml | 39 ++++++++++++++++++ CONTRIBUTING.md | 6 +++ README.md | 75 ++++++++++------------------------ 3 files changed, 67 insertions(+), 53 deletions(-) create mode 100644 .github/workflows/pr-check.yml diff --git a/.github/workflows/pr-check.yml b/.github/workflows/pr-check.yml new file mode 100644 index 0000000..99fbc52 --- /dev/null +++ b/.github/workflows/pr-check.yml @@ -0,0 +1,39 @@ +name: PR Description Check + +on: + pull_request: + types: [opened, edited, synchronize] + +jobs: + check-links: + runs-on: ubuntu-latest + steps: + - name: Check PR description for required links + uses: actions/github-script@v7 + with: + script: | + const body = context.payload.pull_request.body || ''; + + const hasClawhubLink = /https:\/\/clawhub\.ai\/[\w-]+\/[\w-]+/.test(body); + const hasGithubLink = /https:\/\/github\.com\/openclaw\/skills\/tree\/main\/skills\/[\w-]+\/[\w-]+/.test(body); + + const errors = []; + if (!hasClawhubLink) { + errors.push('Missing ClawHub link (e.g. https://clawhub.ai/steipete/slack)'); + } + if (!hasGithubLink) { + errors.push('Missing GitHub link (e.g. https://github.com/openclaw/skills/tree/main/skills/steipete/slack)'); + } + + if (errors.length > 0) { + const message = `## ❌ PR Description Check Failed\n\nYour PR description must include both links:\n\n${errors.map(e => '- ' + e).join('\n')}\n\nSee [CONTRIBUTING.md](../blob/main/CONTRIBUTING.md#pr-description) for details.`; + + await github.rest.issues.createComment({ + owner: context.repo.owner, + repo: context.repo.repo, + issue_number: context.issue.number, + body: message + }); + + core.setFailed('PR description is missing required links.'); + } diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 67c33fe..817260b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -33,6 +33,12 @@ If an author has multiple skills in the same area, please don't add them one by - Skill must have real community usage. We focus on community-adopted, proven skills published by development teams and proven in real-world usage. Brand new skills are not accepted — give your skill time to mature and gain users before submitting - No crypto, blockchain, DeFi, or finance-related skills for now +### PR Description + +Include both the ClawHub and GitHub links for your skill in the PR description, for example: +- `https://clawhub.ai/steipete/slack` +- `https://github.com/openclaw/skills/tree/main/skills/steipete/slack` + ### PR Title `Add skill: author/skill-name` diff --git a/README.md b/README.md index 3813636..c3ce637 100644 --- a/README.md +++ b/README.md @@ -28,20 +28,17 @@ # Awesome OpenClaw Skills -OpenClaw (previously known as Moltbot, originally Clawdbot... identity crisis included, no extra charge) is a locally-running AI assistant that operates directly on your machine. Skills extend its capabilities, allowing it to interact with external services, automate workflows, and perform specialized tasks. This collection helps you discover and install the right skills for your needs. - -Skills in this list are sourced from [ClawHub](https://www.clawhub.ai/) (OpenClaw's public skills registry) and categorized for easier discovery. - +OpenClaw is a locally-running AI assistant that operates directly on your machine. Skills extend its capabilities, allowing it to interact with external services, automate workflows, and perform specialized tasks. This collection helps you discover and install the right skills for your needs. It can also serve as a source of inspiration for OpenClaw use cases. +Skills in this list are sourced from ClawHub (OpenClaw's public skills registry) and categorized for easier discovery. ## Installation ### ClawHub CLI -> **Note:** As you probably know, they keep renaming things. This reflects the current official docs. We'll update this when they rename it again. ```bash -npx clawhub@latest install +clawhub install ``` ### Manual Installation @@ -68,14 +65,28 @@ OpenClaw's public registry (ClawHub) hosts **13,729 community-built skills** as |--------|----------| | Possibly spam — bulk accounts, bot accounts, test/junk | 4,065 | | Duplicate / Similar name | 1,040 | -| Non-English — descriptions not in English | 604 | -| Crypto / Blockchain / Finance / Trade | 573 | +| Low-quality or non-English descriptions | 851 | +| Crypto / Blockchain / Finance / Trade | 611 | | Malicious — identified by security audits published by researchers (excluding VirusTotal) | 373 | -| No or inadequate description — version numbers, metadata, under 3 words | 247 | -| ERC / x402 / a2a protocol skills | 38 | | **Total not taken from OpenClaw's official skill registry** | **6,940** | +### Want to add a skill? + +This list only includes skills that are **already published** in the `github.com/openclaw/skills` repository. We do not accept links to personal repos, gists, or any other external source. If your skill isn't in the OpenClaw skills repo yet, publish it there first. + +Include both the ClawHub link (e.g. `https://clawhub.ai/steipete/slack`) and the GitHub link (e.g. `https://github.com/openclaw/skills/tree/main/skills/steipete/slack`) in your PR description. See [CONTRIBUTING.md](CONTRIBUTING.md) for details. + + +## OpenClaw Ecosystem Tools + +> **Your product here** — Sponsor spots are for tools, platforms, and services built for the OpenClaw ecosystem (hosting, deployment, model providers, dev tools, etc.) +> +> 📈 870K monthly views — the #1 most visited community resource after the official OpenClaw website. +> 📩 For sponsorship inquiries, reach out at necati@voltagent.dev + + + ## Security Notice Skills in this list are **curated, not audited**. They may be updated, modified, or replaced by their original maintainers at any time after being added here. @@ -89,7 +100,6 @@ Before installing or using any Agent Skill, review potential security risks and > Agent skills can include prompt injections, tool poisoning, hidden malware payloads, or unsafe data handling patterns. Always review the source code before installing and use skills at your own discretion. -**Want to add a skill?** This list only includes skills that are **already published** in the `github.com/openclaw/skills` repository. We do not accept links to personal repos, gists, or any other external source. If your skill isn't in the OpenClaw skills repo yet, publish it there first. See [CONTRIBUTING.md](CONTRIBUTING.md) for details. If you believe a skill in this list should be flagged or has a security concern, please [open an issue](https://github.com/VoltAgent/awesome-clawdbot-skills/issues) so we can review it. @@ -111,47 +121,6 @@ If you believe a skill in this list should be flagged or has a security concern, | [Health & Fitness](#health--fitness) (88) | [Agent-to-Agent Protocols](#agent-to-agent-protocols) (17) | | -## OpenClaw Deployment Stack - - Setup, hosting, and deployment providers for OpenClaw agents. - -**Sponsor spots are reserved for hosting, deployment, and setup providers serving OpenClaw developers & users.** - -📈 Monthly 240,000 unique visitors from the OpenClaw audience. - -📩 For sponsorship inquiries, reach out at necati@voltagent.dev - -
- -
- - -Gold Sponsor - - -Your product description here — a one-liner about what you offer to OpenClaw developers. - -
- -Silver Sponsor   Silver Sponsor - -Short description here.                              Short description here. - -
- - - - -Bronze Sponsor  Bronze Sponsor  Bronze Sponsor - -
- -
- - - - -

Git & GitHub

 @@ -167,7 +136,7 @@ If you believe a skill in this list should be flagged or has a security concern, - [arc-security-audit](https://github.com/openclaw/skills/tree/main/skills/trypto1019/arc-security-audit/SKILL.md) - Comprehensive security audit for an agent's full skill stack. - [arc-skill-gitops](https://github.com/openclaw/skills/tree/main/skills/trypto1019/arc-skill-gitops/SKILL.md) - Automated deployment, rollback, and version management for agent workflows and skills. - [arc-trust-verifier](https://github.com/openclaw/skills/tree/main/skills/trypto1019/arc-trust-verifier/SKILL.md) - Verify skill provenance and build trust scores for ClawHub skills. -- [arguedotfun](https://github.com/openclaw/skills/tree/main/skills/albert-mr/arguedotfun/SKILL.md) - Argument-driven prediction markets on Base. +- [arguedotfun](https://github.com/openclaw/skills/tree/main/skills/albert-mr/arguedotfun) - Argument-driven prediction markets on Base. - [arxiv-search-collector](https://github.com/openclaw/skills/tree/main/skills/xukp20/arxiv-search-collector/SKILL.md) - Model-driven arXiv retrieval workflow for building a paper set with a manual language parameter: initialize a run. - [auto-pr-merger](https://github.com/openclaw/skills/tree/main/skills/autogame-17/auto-pr-merger/SKILL.md) - This skill automates the workflow of checking out a GitHub. - [azhua-skill-vetter](https://github.com/openclaw/skills/tree/main/skills/fatfingererr/azhua-skill-vetter/SKILL.md) - Security-first skill vetting for AI agents.