clawhub-skill-lint

Solid

Use this skill before publishing any ClawHub skill from this repo, or after editing a SKILL.md, to verify the skill won't be flagged or rejected by ClawHub's server-side moderation pipeline. The skill re-implements every static-scanner rule from openclaw/clawhub's `convex/lib/moderationEngine.ts` plus the frontmatter spec from `docs/skill-format.md` and runs them locally. Triggers: "lint the claws skills", "check the claws/openclaw skills", "scan before publish", "is the skill clean", "any scanner findings", /clawhub-skill-lint, before any `clawhub sync` or `clawhub skill publish`.

Code & Development 35 stars 9 forks Updated today MIT

Install

View on GitHub

Quality Score: 73/100

Stars 20%
52
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# clawhub-skill-lint A pre-publish validator for ClawHub skills. Catches publish-time failures locally — no network round-trip, no `clawhub` CLI required. ## When to use - **Before** running `clawhub sync` or `clawhub skill publish`. - **After** editing any `SKILL.md`, `README.md`, or other text file in a ClawHub skill folder, to confirm no new patterns trigger the scanner. - **In CI** as a pre-publish gate. - Whenever the user asks "is this skill clean", "will this pass review", or "scan before I publish". ## How to invoke The skill bundles a Python linter at `.claude/skills/clawhub-skill-lint/scripts/lint.py`. Call it with one or more paths: ```bash # Lint a single skill folder python3 .claude/skills/clawhub-skill-lint/scripts/lint.py claws/openclaw/sageox # Lint every skill under a parent directory python3 .claude/skills/clawhub-skill-lint/scripts/lint.py claws/openclaw # Multiple paths in one invocation python3 .claude/skills/clawhub-skill-lint/scripts/lint.py claws/openclaw/sageox claws/openclaw/<other-skill> # Machine-readable JSON output (for CI) python3 .claude/skills/clawhub-skill-lint/scripts/lint.py --json claws/openclaw # Treat warnings as errors python3 .claude/skills/clawhub-skill-lint/scripts/lint.py --strict claws/openclaw ``` The linter discovers skill folders by looking for `SKILL.md` (or `skill.md`). A path that contains `SKILL.md` directly is treated as a single skill; any other directory is scanned for child folders. **Exit codes:** | Cod...

Details

Author
sageox
Repository
sageox/ox
Created
3 months ago
Last Updated
today
Language
Go
License
MIT

Related Skills

Code & Development Featured

code-reviewer

Analyzes code diffs and files to identify bugs, security vulnerabilities (SQL injection, XSS, insecure deserialization), code smells, N+1 queries, naming issues, and architectural concerns, then produces a structured review report with prioritized, actionable feedback. Use when reviewing pull requests, conducting code quality audits, identifying refactoring opportunities, or checking for security issues. Invoke for PR reviews, code quality checks, refactoring suggestions, review code, code quality. Complements specialized skills (security-reviewer, test-master) by providing broad-scope review across correctness, performance, maintainability, and test coverage in a single pass.

9,342 Updated 5 days ago
Jeffallan
Code & Development Featured

security-reviewer

Identifies security vulnerabilities, generates structured audit reports with severity ratings, and provides actionable remediation guidance. Use when conducting security audits, reviewing code for vulnerabilities, or analyzing infrastructure security. Invoke for SAST scans, penetration testing, DevSecOps practices, cloud security reviews, dependency audits, secrets scanning, or compliance checks. Produces vulnerability reports, prioritized recommendations, and compliance checklists.

9,342 Updated 5 days ago
Jeffallan
Code & Development Featured

parallel-investigation

Coordinates parallel investigation threads to simultaneously explore multiple hypotheses or root causes across different system areas. Use when debugging production incidents, slow API performance, multi-system integration failures, or complex bugs where the root cause is unclear and multiple plausible theories exist; when serial troubleshooting is too slow; or when multiple investigators can divide root-cause analysis work. Provides structured phases for problem decomposition, thread assignment, sync points with Continue/Pivot/Converge decisions, and final report synthesis.

745 Updated 1 months ago
rohitg00