# Send Semver Helper 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. 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. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "semver-helper",
    "name": "Semver Helper",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/avegancafe/semver-helper",
    "canonicalUrl": "https://clawhub.ai/avegancafe/semver-helper",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/semver-helper",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=semver-helper",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "semver-helper",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-08T16:46:39.009Z",
      "expiresAt": "2026-05-15T16:46:39.009Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=semver-helper",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=semver-helper",
        "contentDisposition": "attachment; filename=\"semver-helper-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "semver-helper"
      },
      "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/semver-helper"
    },
    "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/semver-helper",
    "downloadUrl": "https://openagent3.xyz/downloads/semver-helper",
    "agentUrl": "https://openagent3.xyz/skills/semver-helper/agent",
    "manifestUrl": "https://openagent3.xyz/skills/semver-helper/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/semver-helper/agent.md"
  }
}
```
## Documentation

### Semver Helper

Quick reference for Semantic Versioning 2.0.0 decisions.

### The Golden Rule

Given version MAJOR.MINOR.PATCH, increment:

LevelBump WhenReset Lower?MAJOR (X.0.0)Breaking changes (incompatible API changes)Yes, MINOR and PATCH → 0MINOR (0.X.0)New features (backwards compatible)Yes, PATCH → 0PATCH (0.0.X)Bug fixes (backwards compatible)No

### Quick Decision Tree

Did you change anything users depend on?
├─ No (internal only) → PATCH
└─ Yes
   └─ Did you remove/change existing behavior?
      ├─ Yes → MAJOR
      └─ No (only added new stuff)
         └─ Is the new stuff visible to users?
            ├─ Yes → MINOR
            └─ No → PATCH

### 🔴 MAJOR (Breaking)

Remove a function, endpoint, or CLI flag
Change the return type of a function
Require a new mandatory parameter
Change default behavior significantly
Rename something users depend on
Upgrade a dependency that forces downstream changes

Examples:

removeUser() → deleteUser() rename
API response format changed from {id: 1} to {data: {id: 1}}
Dropping support for Node 16 (if users must upgrade)

### 🟡 MINOR (Feature)

Add new functionality
Add optional parameters
Add new exports/exports
Deprecate old features (warn, don't remove)
Performance improvements (no API change)

Examples:

Add createUser() alongside existing user functions
Add --format json flag to CLI
Add new event listeners/hooks
Mark old method as deprecated (still works)

### 🟢 PATCH (Fix)

Fix bugs without changing intended behavior
Documentation updates
Internal refactoring (no visible change)
Dependency updates (no API change)
Test additions

Examples:

Fix null pointer exception
Correct typo in error message
Fix race condition
Update README

### Version Progression Examples

ChangesVersion Bumpfix: null pointer1.2.3 → 1.2.4feat: add auth1.2.3 → 1.3.0breaking: remove old API1.2.3 → 2.0.0fix: bug + feat: new thing1.2.3 → 1.3.0 (MINOR wins)fix: bug + breaking: remove API1.2.3 → 2.0.0 (MAJOR wins)

### Pre-releases

Use suffixes for testing before stable:

2.0.0-alpha.1 — Very early, unstable
2.0.0-beta.2 — Feature complete, testing
2.0.0-rc.1 — Release candidate, final testing

Pre-releases sort before their stable version:
1.0.0-alpha < 1.0.0-beta < 1.0.0-rc < 1.0.0

### Common Edge Cases

SituationBumpWhyFix a bug that was introduced this versionPATCHStill a fixDeprecate a feature (but keep it working)MINORNew "deprecated" state is infoChange undocumented/internal behaviorPATCHUsers shouldn't depend on itSecurity fix that requires API changeMAJORBreaking for securityRewriting internals, same behaviorPATCHInvisible to usersAdding tests/docs onlyPATCHNo code change

### Anti-Patterns

❌ Don't bump MAJOR for big new features (unless breaking)
❌ Don't bump MINOR for bug fixes
❌ Don't bump PATCH for new functionality
❌ Don't keep old numbers when bumping: 1.2.3 → 2.2.3 is wrong

### Cheat Sheet

Users' code breaks? → MAJOR
Users get new toys? → MINOR
Users get fixes? → PATCH
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: avegancafe
- Version: 1.0.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-05-08T16:46:39.009Z
- Expires at: 2026-05-15T16:46:39.009Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/semver-helper)
- [Send to Agent page](https://openagent3.xyz/skills/semver-helper/agent)
- [JSON manifest](https://openagent3.xyz/skills/semver-helper/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/semver-helper/agent.md)
- [Download page](https://openagent3.xyz/downloads/semver-helper)