Gerenciamento obrigatório de CHANGELOG e versionamento seguindo Keep a Changelog e Semantic Versioning em todos os projetos.
63%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/workflow/changelog/SKILL.mdRegras obrigatórias para manter CHANGELOG em todos os projetos seguindo o padrão Keep a Changelog.
Aplicar esta skill em TODOS os projetos quando:
CHANGELOG obrigatório em todos os projetos:
CHANGELOG.md na raizAgentes só podem modificar versão não lançada:
[1.2.0])[Unreleased]Todas as mudanças devem estar no CHANGELOG:
Formato obrigatório:
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
### Added
- Nova funcionalidade X
### Changed
- Melhoria Y
### Fixed
- Correção Z
## [1.2.0] - 2025-12-08
### Added
- Versão anterior...Antes de fazer mudanças:
CHANGELOG.md existeDurante as mudanças:
[Unreleased]Antes de commitar:
[Unreleased]Ao criar release:
[Unreleased] para nova versão com data## [Unreleased]
### Added
- Nova skill `changelog-management` para gerenciamento obrigatório de CHANGELOG
- Script `utils/database.py` genérico para queries SQL puro (Django)
### Changed
- `.gitignore` simplificado usando pastas ao invés de listar arquivos
- `skills/README.md` atualizado para referenciar scripts genéricos
### Security
- Removidas referências a projetos de trabalho confidenciaisCHANGELOG.md existe na raiz do projeto[Unreleased]Se o projeto não tem CHANGELOG, criar com este template:
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
### Added
- Initial project setup
---
[Unreleased]: https://github.com/USER/REPO/compare/v1.0.0...HEADEste projeto segue Semantic Versioning 2.0.0:
1.0.0 → 1.1.0: Nova funcionalidade adicionada1.1.0 → 1.1.1: Bug corrigido1.1.1 → 2.0.0: Mudança que quebra compatibilidadeAtualizar versão nos arquivos
CHANGELOG.md (mover [Unreleased] para nova versão)Commit e Tag
git commit -m "chore: release v1.2.0"
git tag -a v1.2.0 -m "Release version 1.2.0"
git push origin main --tagsCriar Release no GitHub (se aplicável)
Antes de commitar, sempre verificar:
# Verificar diff antes de commitar
git diff
# Procurar por tokens
grep -r "ntn_" .
grep -r "secret_" .
grep -r "password" .Use sempre placeholders em documentação:
# ✗ ERRADO - Nunca commite tokens reais
TOKEN = 'ntn_ABC123XYZ456REAL_TOKEN_HERE'
# ✓ CORRETO - Use placeholders
TOKEN = 'ntn_YOUR_NOTION_TOKEN_HERE'f84a77a
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.