From b501b2d568b02878c3160087c3dff17572726a7e Mon Sep 17 00:00:00 2001 From: Tim Hsiung Date: Sat, 9 May 2026 14:43:14 +0800 Subject: [PATCH] docs(skill): remove broken doc references and unused compatibility field The `Suggested references` section listed paths relative to the repo root (e.g. `docs/commands/commit.md`), but per the Agent Skills specification, file references should be relative to the skill root. When the skill folder is installed standalone, those paths do not resolve, so the section was effectively dead pointers. Drop the section and rely on agent inference / the documented `metadata.docs` URL for the canonical docs. Also drop the `compatibility` frontmatter field. The spec notes most skills do not need it, and the previous value did not describe a constraint that would prevent the skill from running. Refs commitizen-tools/commitizen#1936 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .agents/skills/commitizen/SKILL.md | 19 ------------------- 1 file changed, 19 deletions(-) diff --git a/.agents/skills/commitizen/SKILL.md b/.agents/skills/commitizen/SKILL.md index 0aa3871b8..920c9cc88 100644 --- a/.agents/skills/commitizen/SKILL.md +++ b/.agents/skills/commitizen/SKILL.md @@ -2,7 +2,6 @@ name: commitizen description: Use this skill for tasks involving Conventional Commits, commit message validation, Commitizen configuration, semantic version bumps, changelog generation, or CI/release automation with the Commitizen CLI. license: MIT -compatibility: Git repository with Python and Commitizen available as `cz` or runnable from source. Network access is optional and mainly relevant for CI or release integrations. metadata: project: commitizen-tools/commitizen docs: https://commitizen-tools.github.io/commitizen/ @@ -46,24 +45,6 @@ Commitizen is a CLI for enforcing Conventional Commits, automating version bumps - `cz commit` supports `--dry-run` and `--write-message-to-file`. - `cz check` can validate a literal message, a commit-msg file, or a git revision range. -## Suggested references - -- Command docs: - - `docs/commands/commit.md` - - `docs/commands/bump.md` - - `docs/commands/changelog.md` - - `docs/commands/check.md` - - `docs/commands/init.md` -- Config docs: - - `docs/config/configuration_file.md` - - `docs/config/option.md` - - `docs/config/bump.md` -- Automation docs: - - `docs/tutorials/github_actions.md` - - `docs/tutorials/gitlab_ci.md` -- Error handling: - - `docs/exit_codes.md` - ## Examples - Validate one message: `cz check --message "feat(cli): add release command"`