About

Imported from terminalskills/skills (skills/semantic-release/SKILL.md). Install upstream with npx skills add terminalskills/skills --skill semantic-release. Copyright stays with the author (Apache-2.0).

semantic-release

Name: semantic-release
Author: terminalskills

Overview

semantic-release automates the release workflow: determine version bump from commit messages, generate changelog, create Git tag, publish to npm, create GitHub release.

Instructions

Step 1: Setup

npm install -D semantic-release @semantic-release/changelog @semantic-release/git

Step 2: Configure

// .releaserc.json — Release configuration
{
  "branches": ["main"],
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    ["@semantic-release/changelog", { "changelogFile": "CHANGELOG.md" }],
    "@semantic-release/npm",
    ["@semantic-release/git", { "assets": ["CHANGELOG.md", "package.json"] }],
    "@semantic-release/github"
  ]
}

Step 3: CI Integration

Add to your CI pipeline (GitHub Actions, GitLab CI, etc.) to run on every push to main. Requires GITHUB_TOKEN and NPM_TOKEN secrets.

Guidelines

Requires conventional commits — feat = minor, fix = patch, BREAKING CHANGE = major.
Use with commitlint + husky to enforce commit format.
Works with monorepos using semantic-release-monorepo plugin.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/terminalskills-skills-semantic-release/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

terminalskills-skills-semantic-release.ocm.jsonjson

{
  "ocm": "1",
  "id": "terminalskills-skills-semantic-release",
  "kind": "skill",
  "name": "semantic-release",
  "description": "Automate versioning and package publishing with semantic-release. Use when a user asks to automate npm publishing, generate changelogs, handle semantic versioning in CI, or automate GitHub releases.",
  "publisher": "terminalskills",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "semantic-release",
      "versioning",
      "changelog",
      "npm",
      "ci-cd",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Automate versioning and package publishing with semantic-release. Use when a user asks to automate npm publishing, generate changelogs, handle semantic versioning in CI, or automate GitHub releases."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/terminalskills/skills",
      "path": "skills/semantic-release/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/terminalskills/skills/blob/HEAD/skills/semantic-release/SKILL.md",
      "key": "terminalskills/skills/skills/semantic-release/SKILL.md"
    },
    "compatibility": "Node.js, any CI",
    "license": "Apache-2.0"
  },
  "instructions": "# semantic-release\n\n## Overview\nsemantic-release automates the release workflow: determine version bump from commit messages, generate changelog, create Git tag, publish to npm, create GitHub release.\n\n## Instructions\n\n### Step 1: Setup\n```bash\nnpm install -D semantic-release @semantic-release/changelog @semantic-release/git\n```\n\n### Step 2: Configure\n```json\n// .releaserc.json — Release configuration\n{\n  \"branches\": [\"main\"],\n  \"plugins\": [\n    \"@semantic-release/commit-analyzer\",\n    \"@semantic-release/release-notes-generator\",\n    [\"@semantic-release/changelog\", { \"changelogFile\": \"CHANGELO",
  "cost": {
    "context_tokens": 284
  }
}

Fetch it by URL: GET /api/v1/registry/terminalskills-skills-semantic-release/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.