feat(skills): enrich issue and PR description templates - #17
Merged
Conversation
Add structured templates with conventional commit-style titles, Mermaid diagrams for architecture and task dependencies, and clearer sections for implementers and reviewers. Includes guidelines for when to include or skip diagrams. https://claude.ai/code/session_011JVre5FaeksW5dnqZFCDzw
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Enrich the
/tasksand/shipskill templates to produce higher-quality GitHub issues and PRs. Adds conventional commit-style titles, structured sections, and Mermaid diagram support.What changed
skills/tasks/SKILL.md: Redesigned issue body template with objective, acceptance criteria (Given/When/Then), architecture overview diagram, task dependency graph, and implementer context section. Added conventional commit title format (type(scope): description).skills/ship/SKILL.md: Redesigned PR body template with change overview diagram, step-by-step test instructions, breaking changes section, and conventional commit title format. Updated gotchas to reinforce title conventions.Change overview
graph TD A["/tasks skill"] -->|creates| B["GitHub Issue"] C["/ship skill"] -->|creates| D["Pull Request"] B -->|conventional commit title| E["type(scope): description"] D -->|conventional commit title| E B -->|includes| F["Mermaid: architecture + task deps"] D -->|includes| G["Mermaid: change overview"]How to test
skills/tasks/SKILL.md(Step 4) andskills/ship/SKILL.md(Step 5)/taskson a sample spec+plan — verify the issue has structured sections and diagrams/shipafter implementation — verify the PR has the enriched templatetype(scope): descriptionformatBreaking changes
None — existing skills produce richer output with no behavioral changes.
References
https://claude.ai/code/session_011JVre5FaeksW5dnqZFCDzw