mcp-obsidian-via-rest: Skill for Claude Code

Release-It Skill

Automate NPM package versioning, changelog generation, and publishing with release-it.

Core Workflow Overview

Setting up release-it involves these steps:

1. Install release-it and plugins
2. Create configuration file (.release-it.json)
3. Configure Git and GitHub settings
4. Set up changelog generation (optional but recommended)
5. Create GitHub Actions workflow for CI/CD
6. Configure authentication (NPM_TOKEN or OIDC)

Step 1: Installation

# Recommended: interactive setup
npm init release-it

# Manual installation
npm install --save-dev release-it
npm install --save-dev @release-it/conventional-changelog  # Optional: for changelogs

Add scripts to package.json:

{
  "scripts": {
    "release": "release-it",
    "release:dry": "release-it --dry-run",
    "release:ci": "release-it --ci"
  }
}

Requirement: Node.js 20 or higher for release-it v19+.

Step 2: Configuration File

Create .release-it.json in project root. See references/config-options.md for all options.

Minimal Configuration

{
  "$schema": "https://unpkg.com/release-it@19/schema/release-it.json",
  "git": {
    "commitMessage": "chore: release v${version}",
    "tagName": "v${version}"
  },
  "github": {
    "release": true
  },
  "npm": {
    "publish": true
  }
}

Production Configuration (Recommended)

{
  "$schema": "https://unpkg.com/release-it@19/schema/release-it.json",
  "git": {
    "commitMessage": "chore: release v${version}",
    "tagName": "v${version}",
    "requireBranch": "main",
    "requireCleanWorkingDir": true,
    "requireCommits": true,
    "requireUpstream": true
  },
  "github": {
    "release": true,
    "releaseName": "v${version}"
  },
  "npm": {
    "publish": true
  },
  "hooks": {
    "before:init": ["npm run lint", "npm test"],
    "after:bump": "npm run build"
  },
  "plugins": {
    "@release-it/conventional-changelog": {
      "preset": {
        "name": "conventionalcommits",
        "types": [
          { "type": "feat", "section": "Features" },
          { "type": "fix", "section": "Bug Fixes" },
          { "type": "perf", "section": "Performance" }
        ]
      },
      "infile": "CHANGELOG.md",
      "header": "# Changelog"
    }
  }
}