# Send vibe-check to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "vibe-check",
    "name": "vibe-check",
    "source": "tencent",
    "type": "skill",
    "category": "安全合规",
    "sourceUrl": "https://clawhub.ai/tkuehnl/vibe-check",
    "canonicalUrl": "https://clawhub.ai/tkuehnl/vibe-check",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/vibe-check",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vibe-check",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "SECURITY.md",
      "SKILL.md",
      "TESTING.md",
      "scripts/analyze.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "vibe-check",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T20:14:29.347Z",
      "expiresAt": "2026-05-06T20:14:29.347Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vibe-check",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vibe-check",
        "contentDisposition": "attachment; filename=\"vibe-check-0.2.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "vibe-check"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/vibe-check"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/vibe-check",
    "downloadUrl": "https://openagent3.xyz/downloads/vibe-check",
    "agentUrl": "https://openagent3.xyz/skills/vibe-check/agent",
    "manifestUrl": "https://openagent3.xyz/skills/vibe-check/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/vibe-check/agent.md"
  }
}
```
## Documentation

### 🎭 Vibe Check

Audit code for "vibe coding" — AI-generated code accepted without proper human review. Get a scored report card with specific findings and fix suggestions.

### Trigger

Activate when the user mentions any of:

"vibe check"
"vibe-check"
"audit code"
"code quality"
"vibe score"
"check my code"
"review this code for vibe coding"
"code review"
"vibe audit"

### 1. Determine the Target

Ask the user what code to analyze. Accepted inputs:

Single file: app.py, src/utils.ts
Directory: src/, ., my-project/
Git diff: last N commits, staged changes, or branch comparison

### 2. Run the Analysis

# Single file or directory
bash "$SKILL_DIR/scripts/vibe-check.sh" TARGET

# With fix suggestions
bash "$SKILL_DIR/scripts/vibe-check.sh" --fix TARGET

# Git diff (last 3 commits)
bash "$SKILL_DIR/scripts/vibe-check.sh" --diff HEAD~3

# Staged changes with fixes
bash "$SKILL_DIR/scripts/vibe-check.sh" --staged --fix

# Save to file
bash "$SKILL_DIR/scripts/vibe-check.sh" --fix --output report.md TARGET

### 3. Present the Report

The output is a Markdown report. Present it directly — it's designed to be screenshot-worthy.

### Discord v2 Delivery Mode (OpenClaw v2026.2.14+)

When the conversation is happening in a Discord channel:

Send a compact summary first (grade, score, file count, top 3 findings), then ask if the user wants the full report.
Keep the first message under ~1200 characters and avoid wide Markdown tables in the first response.
If Discord components are available, include quick actions:

Show Top Findings
Show Fix Suggestions
Run Diff Mode


If components are not available, provide the same follow-ups as a numbered list.
Prefer short follow-up chunks (<=15 lines per message) when sending the full report.

### Quick Reference

CommandDescriptionvibe-check FILEAnalyze a single filevibe-check DIRScan directory recursivelyvibe-check --diffCheck last commit's changesvibe-check --diff HEAD~5Check last 5 commitsvibe-check --stagedCheck staged changesvibe-check --fix DIRInclude fix suggestionsvibe-check --output report.md DIRSave report to file

### Sin Categories (what it checks)

CategoryWeightWhat It CatchesError Handling20%Missing try/catch, bare exceptions, no edge casesInput Validation15%No type checks, no bounds checks, trusting all inputDuplication15%Copy-pasted logic, DRY violationsDead Code10%Unused imports, commented-out blocks, unreachable codeMagic Values10%Hardcoded strings/numbers/URLs without constantsTest Coverage10%No test files, no test patterns, no assertionsNaming Quality10%Vague names (data, result, temp, x), misleading namesSecurity10%eval(), exec(), hardcoded secrets, SQL injection

### Scoring

A (90-100): Pristine code, minimal issues
B (80-89): Clean code with minor issues
C (70-79): Decent but lazy patterns crept in
D (60-69): Needs human attention
F (<60): Heavy vibe coding detected

### Notes for the Agent

The report is the star. Present it in full — it's designed to look great.
After presenting, offer to run --fix mode if they didn't already.
Suggest the README badge: ![Vibe Score](https://img.shields.io/badge/vibe--score-XX%2F100-COLOR)
For large codebases, suggest focusing on specific directories or using --diff mode.
If no LLM API key is set, the tool falls back to heuristic analysis (less accurate but still useful).
Supported languages (v1): Python, TypeScript, JavaScript only.

### References

scripts/vibe-check.sh — Main entry point
scripts/analyze.sh — LLM code analysis engine (with heuristic fallback)
scripts/git-diff.sh — Git diff file extractor
scripts/report.sh — Markdown report generator
scripts/common.sh — Shared utilities and constants

### Example 1: Audit a Directory

User: "Vibe check my src directory"

Agent runs:

bash "$SKILL_DIR/scripts/vibe-check.sh" src/

Output: Full scorecard with per-file breakdown, category scores, and top findings.

### Example 2: Check with Fixes

User: "Review this code for vibe coding and suggest fixes"

Agent runs:

bash "$SKILL_DIR/scripts/vibe-check.sh" --fix src/

Output: Scorecard + unified diff patches for each finding.

### Example 3: Git Diff Mode

User: "Check the code quality of my last 3 commits"

Agent runs:

bash "$SKILL_DIR/scripts/vibe-check.sh" --diff HEAD~3

Output: Scorecard focused only on recently changed files.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: tkuehnl
- Version: 0.2.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T20:14:29.347Z
- Expires at: 2026-05-06T20:14:29.347Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/vibe-check)
- [Send to Agent page](https://openagent3.xyz/skills/vibe-check/agent)
- [JSON manifest](https://openagent3.xyz/skills/vibe-check/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/vibe-check/agent.md)
- [Download page](https://openagent3.xyz/downloads/vibe-check)