SKILL.md
Git-Jira Integration Skill
Bridges Git workflows with Jira project management. Provides consistent naming, validation, and context generation to maintain traceability between code and issues.
Allowed Operations
- Link Git repositories to Jira projects
- Generate branch names from Jira issues
- Validate commit messages against conventions
- Generate PR context from Jira specifications
- List linked repositories
Forbidden Operations
These are NOT performed by this skill - agents have their own Git tools:
- Execute Git commands (clone, pull, push, commit)
- Create/merge Pull Requests directly
- Modify repository settings
- Access repository files or code
MCP Tools
| Tool | Purpose |
|---|---|
devflowgitlink_repo |
Link repository to Jira project |
devflowgitget_repos |
List linked repositories |
devflowgitbranch_name |
Generate branch name from issue |
devflowgitvalidate_commit |
Validate commit message format |
devflowgitpr_context |
Generate PR title, body, checklist |
Constraints
- Branch names follow pattern:
{type}/{issueKey}-{slug} - Commit messages should follow Conventional Commits
- Commit messages should include issue key reference
- PR context requires existing Jira issues
Quick Reference
Branch Naming
Generate branch name:
devflow_git_branch_name(issueKey: "PROJ-123")Result: feature/proj-123-add-user-authentication
Commit Validation
Validate commit message:
devflow_git_validate_commit(
message: "feat(auth): add login page\n\nRefs: PROJ-123",
projectKey: "PROJ",
requireIssueKey: true
)PR Context
Generate PR context:
devflow_git_pr_context(
issueKeys: ["PROJ-123", "PROJ-124"],
includeAcceptanceCriteria: true
)For detailed conventions, see [BRANCH-CONVENTIONS.md](references/BRANCH-CONVENTIONS.md).
For commit message format, see [COMMIT-MESSAGE-FORMAT.md](references/COMMIT-MESSAGE-FORMAT.md).
For PR templates, see [PR-TEMPLATES.md](references/PR-TEMPLATES.md).
Example Workflow
- Start work on issue:
`` # Get branch name from Jira issue devflowgitbranch_name(issueKey: "PROJ-123") # Agent creates branch with their git tools ``
- Validate commits:
`` # Before committing, validate message devflowgitvalidate_commit(message: "feat: add login") ``
- Create PR:
`` # Get PR context from Jira devflowgitpr_context(issueKeys: ["PROJ-123"]) # Agent creates PR with their gh/git tools ``
Repository Linking
Link a repository to get project-specific defaults:
devflow_git_link_repo(
projectKey: "PROJ",
repositoryUrl: "https://github.com/company/project",
defaultBranch: "develop",
branchPattern: "{type}/{key}-{slug}"
)List linked repositories:
devflow_git_get_repos()
devflow_git_get_repos(projectKey: "PROJ")