← 返回 Skills 市场

Changelog Linter

Name: Changelog Linter
Author: charlie-morrison

作者 charlie-morrison · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install changelog-linter

功能描述

Validate CHANGELOG.md files against the Keep a Changelog format (keepachangelog.com). Checks version ordering, date formats, section types, link references,...

使用说明 (SKILL.md)

Changelog Linter

Validate CHANGELOG.md files against the Keep a Changelog specification.

Commands

All commands use the bundled Python script at scripts/changelog_linter.py.

1. Lint a changelog

python3 scripts/changelog_linter.py lint \x3Cfile> [--strict] [--format text|json|markdown]

Run all validation rules against a CHANGELOG.md file.

Flags:

--strict — exit code 1 on any warning (not just errors)
--format — output format: text (default), json, markdown

2. List versions

python3 scripts/changelog_linter.py versions \x3Cfile> [--format text|json]

Extract and display all versions with dates and change counts.

3. Validate version ordering

python3 scripts/changelog_linter.py order \x3Cfile> [--format text|json]

Check that versions are in descending semver order.

4. Check links

python3 scripts/changelog_linter.py links \x3Cfile> [--format text|json]

Verify that all version headers have corresponding link references at the bottom.

Lint Rules (16 total)

Structure (5 rules)

missing-title — File doesn't start with # Changelog
missing-description — No description paragraph after title
no-versions — No version entries found
empty-version — Version section has no change entries
unreleased-missing — No [Unreleased] section

Versions (4 rules)

invalid-version — Version doesn't follow semver (MAJOR.MINOR.PATCH)
invalid-date — Date doesn't follow ISO 8601 (YYYY-MM-DD)
version-order — Versions not in descending order
duplicate-version — Same version appears twice

Sections (3 rules)

invalid-section — Section type not in spec (Added/Changed/Deprecated/Removed/Fixed/Security)
empty-section — Section header with no list items
section-order — Sections not in recommended order

Formatting (4 rules)

missing-link-ref — Version header has no corresponding link reference
broken-link-ref — Link reference exists but URL is empty or malformed
inconsistent-bullets — Mixed bullet styles (- and *)
trailing-whitespace — Lines with trailing whitespace

Output Formats

Text (default)

CHANGELOG.md:15 error [invalid-date] Version 1.2.0 has invalid date: "March 2024" (expected YYYY-MM-DD)
CHANGELOG.md:28 warning [empty-section] Section "Deprecated" under 1.1.0 has no entries
CHANGELOG.md:45 warning [missing-link-ref] Version 1.0.0 has no link reference

3 issues (1 error, 2 warnings)

JSON / Markdown

Standard structured output with issues, summary, and version list.

CI Integration

- name: Lint Changelog
  run: python3 scripts/changelog_linter.py lint CHANGELOG.md --strict

Exit codes: 0 = valid, 1 = issues found.

安全使用建议

This skill appears coherent and low-risk: it bundles a pure-Python linter that only reads the changelog file you point it at and reports formatting/version/link issues. Before installing or running: (1) skim the full scripts/changelog_linter.py to verify there are no unexpected filesystem or network operations (the visible code uses only stdlib parsing); (2) run it in a restricted environment (CI container or sandbox) first, especially if you will feed it sensitive files; and (3) remember it will read the file(s) you pass it (so do not point it at directories or files you don't intend to analyze). The STATUS.md notes a price; that is unrelated to technical behavior but may affect purchasing decisions.

功能分析

Type: OpenClaw Skill Name: changelog-linter Version: 1.0.0 The changelog-linter skill is a legitimate utility designed to validate CHANGELOG.md files against the 'Keep a Changelog' specification. The core logic in scripts/changelog_linter.py uses standard Python libraries to perform regex-based parsing and structural checks without any network access, suspicious file operations, or obfuscation. No malicious instructions or prompt injection attempts were found in SKILL.md or the supporting documentation.

能力评估

✓ Purpose & Capability

Name/description match the provided assets: SKILL.md describes using the bundled scripts/changelog_linter.py to lint CHANGELOG.md files, and that script is present. The declared capabilities (lint, versions, order, links) align with the functions implemented in the script.

✓ Instruction Scope

SKILL.md instructs the agent to run the included Python script against a supplied CHANGELOG.md file. The script (as shown) parses the provided text and performs static checks; it does not request reading unrelated system files, environment variables, or sending data externally.

✓ Install Mechanism

No install specification is provided (instruction-only plus a bundled script). No remote downloads or package installs are requested. The script claims to use only the Python stdlib.

✓ Credentials

No environment variables, credentials, or config paths are required. The script operates on a file argument, which is proportional to a linter's needs.

✓ Persistence & Privilege

Skill is not always-enabled and does not request modification of agent configuration or persistent presence. It runs on-demand and only executes the local script.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install changelog-linter
安装完成后，直接呼叫该 Skill 的名称或使用 /changelog-linter 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release

元数据

Slug changelog-linter

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题