Generates comprehensive changelogs from Conventional Commits, maintains CHANGELOG.md files, and scaffolds project documentation like PRD.md or ADR.md. This skill should be used when creating changelogs, generating release notes, maintaining version history, documenting architectural decisions, or scaffolding project requirements documentation. Use for changelog generation, release notes, version documentation, ADR, PRD, or technical documentation.
Generates changelogs from Conventional Commits, maintains CHANGELOG.md files, and scaffolds project documentation like ADRs and PRDs. Use this when creating release notes, documenting architectural decisions, or writing product requirement documents.
/plugin marketplace add hopeoverture/worldbuilding-app-skills/plugin install docs-and-changelogs@worldbuilding-app-skillsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
scripts/create_adr.pyscripts/create_prd.pyscripts/generate_changelog.pyGenerate and maintain project documentation including changelogs, architectural decision records, and product requirement documents.
To manage project documentation effectively:
To generate changelogs from Conventional Commits:
Use scripts/generate_changelog.py to automate changelog generation from commit history.
Follow this commit message structure:
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
Types:
feat: New featurefix: Bug fixdocs: Documentation changesstyle: Code style changes (formatting, semicolons, etc.)refactor: Code refactoring without feature changesperf: Performance improvementstest: Adding or updating testschore: Maintenance tasksci: CI/CD changesBreaking Changes:
BREAKING CHANGE: in footer or ! after typefeat!: redesign entity schema structureTo maintain changelog file:
Consult references/changelog-format.md for detailed formatting guidelines and examples.
To create architectural decision records:
scripts/create_adr.py to scaffold new ADR fileUse assets/adr-template.md as starting point for new ADRs.
Standard ADR sections:
To scaffold product requirement documents:
scripts/create_prd.py to generate PRD templateReference assets/prd-template.md for comprehensive PRD structure.
Standard PRD components:
To generate changelog:
Collect Commits
python scripts/generate_changelog.py --since v1.0.0
Categorize Changes
Format Output
Update CHANGELOG.md
To document architectural decision:
Generate ADR File
python scripts/create_adr.py "use postgresql for entity storage"
Fill Template
Review and Commit
To create product requirements:
Generate PRD Template
python scripts/create_prd.py "timeline visualization feature"
Complete Sections
Review with Stakeholders
To automate documentation updates:
Add to .github/workflows/release.yml:
- name: Generate changelog
run: python scripts/generate_changelog.py --output CHANGELOG.md
- name: Commit changelog
run: |
git config user.name github-actions
git config user.email github-actions@github.com
git add CHANGELOG.md
git commit -m "docs: update changelog for ${{ github.ref_name }}"
Add to .git/hooks/commit-msg:
#!/bin/bash
# Validate conventional commit format
python scripts/validate_commit_msg.py "$1"
Organize project documentation:
docs/
├── CHANGELOG.md # Version history
├── ADR/ # Architectural decisions
│ ├── 0001-use-nextjs.md
│ └── 0002-database-choice.md
├── PRD/ # Product requirements
│ ├── timeline-feature.md
│ └── entity-relationships.md
└── api/ # API documentation
└── endpoints.md
To manage semantic versioning:
Use scripts/bump_version.py to update version across package.json, changelog, and tags.
To generate release notes:
Use scripts/generate_release_notes.py to create formatted release notes from changelog.
Common issues:
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.