docs(skill): remove broken doc references and unused compatibility field (#1956)

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 #1936

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: bearomorphism <26526132+bearomorphism@users.noreply.github.com>

Author: 3 people

.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,26 +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`
-- Installation:
-  - `docs/README.md` (see the *Installation* section for global vs project-local options)
-
 ## Examples
 
 - Validate one message: `cz check --message "feat(cli): add release command"`