Title: docs: add Agent Skills SKILL.md by bearomorphism · Pull Request #1949 · commitizen-tools/commitizen · GitHub
Open Graph Title: docs: add Agent Skills SKILL.md by bearomorphism · Pull Request #1949 · commitizen-tools/commitizen
X Title: docs: add Agent Skills SKILL.md by bearomorphism · Pull Request #1949 · commitizen-tools/commitizen
Description: Description
Add a SKILL.md following the Agent Skills spec at .agents/skills/commitizen/SKILL.md, so AI agents working in this repo can auto-discover Commitizen's capabilities.
The file provides concise guidance on command selection, configuration discovery, versioning, changelog generation, CI workflows, and exit-code handling.
Checklist
I have read the contributing guidelines
Was generative AI tooling used to co-author this PR?
Yes (GitHub Copilot CLI)
Generated-by: GitHub Copilot CLI following the guidelines
Code Changes
Add test cases to all the changes you introduce (N/A - docs only)
Run uv run poe all locally to ensure this change passes linter check and tests
Manually test the changes:
Verify the feature/bug fix works as expected in real-world scenarios
Test edge cases and error conditions
Ensure backward compatibility is maintained
Document any manual testing steps performed
Update the documentation for the changes
Documentation Changes
Run uv run poe doc locally to ensure the documentation pages renders correctly
Check and fix any broken links (internal or external)
Expected Behavior
Agents supporting the Agent Skills format (Claude Code, VS Code/Copilot, Cursor, Gemini CLI, OpenAI Codex, etc.) can auto-discover the skill at .agents/skills/commitizen/SKILL.md when working in this repo.
Steps to Test This Pull Request
Verify .agents/skills/commitizen/SKILL.md exists
Check YAML frontmatter includes required name and description fields
Verify directory name (commitizen) matches the name field in frontmatter
Additional Context
Part of #1936. The llms.txt portion is addressed in PR #1948.
Moved from repo root to .agents/skills/commitizen/ based on research showing that compliant agents scan .agents/skills/
Open Graph Description: Description Add a SKILL.md following the Agent Skills spec at .agents/skills/commitizen/SKILL.md, so AI agents working in this repo can auto-discover Commitizen's capabilities. The file provide...
X Description: Description Add a SKILL.md following the Agent Skills spec at .agents/skills/commitizen/SKILL.md, so AI agents working in this repo can auto-discover Commitizen's capabilities. The file pro...
Opengraph URL: https://github.com/commitizen-tools/commitizen/pull/1949
X: @github
Domain: github.com
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:82d6c0bb-f1e3-f200-1830-617a5d14faff |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | CD84:322E35:7F28C6:AB5B21:6A4EC652 |
| html-safe-nonce | ae66f5dd51f969f35a4b2156bf9b1c66721f84dc0d59788217f0a728279ae81d |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDRDg0OjMyMkUzNTo3RjI4QzY6QUI1QjIxOjZBNEVDNjUyIiwidmlzaXRvcl9pZCI6IjIyNDEyNjMxNTY4ODUxMTI0MDIiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 6c5f8fcf4ade77604d8ac1bc73e9729e323ece1fdfee5c3d44648d9e06361660 |
| hovercard-subject-tag | pull_request:3642056022 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/commitizen-tools/commitizen/pull/1949/files |
| twitter:image | https://avatars.githubusercontent.com/u/26526132?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/26526132?s=400&v=4 |
| og:image:alt | Description Add a SKILL.md following the Agent Skills spec at .agents/skills/commitizen/SKILL.md, so AI agents working in this repo can auto-discover Commitizen's capabilities. The file provide... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | 41b6ab3ba6d20a71766ac245b5a4a94c6fc672a9cd4da7d44c1b33ab8bf6a21c |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/commitizen-tools/commitizen git https://github.com/commitizen-tools/commitizen.git |
| octolytics-dimension-user_id | 62252524 |
| octolytics-dimension-user_login | commitizen-tools |
| octolytics-dimension-repository_id | 106127589 |
| octolytics-dimension-repository_nwo | commitizen-tools/commitizen |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 106127589 |
| octolytics-dimension-repository_network_root_nwo | commitizen-tools/commitizen |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | e6a744804e8e70f97b4d5a18a94dcc63db22f97a |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width