netresearch/jira-skill / skills/jira-syntax
jira-syntax
UnverifiedUse when writing or formatting Jira descriptions, comments, or any text destined for Jira. Converts Markdown to Jira wiki markup, provides templates (bug reports, feature requests), and validates syntax before submission. Trigger on any Jira content authoring task.
| File | Kind | Size |
|---|---|---|
| AGENTS.md | markdown | 1.9 KB |
| CLAUDE.md | markdown | 9 B |
| SKILL.md | skill md | 4.2 KB |
| evals/evals.json | config | 7.2 KB |
| references/cross-project-refs.md | markdown | 2.5 KB |
| references/jira-syntax-quick-reference.md | markdown | 17.2 KB |
| scripts/validate-jira-syntax.shexecutable | script | 27.6 KB |
| templates/bug-report-template.md | markdown | 4.0 KB |
| templates/feature-request-template.md | markdown | 7.9 KB |
templates/bug-report-template.md
View on GitHub# Jira Bug Report Template
Use this template when creating bug reports in Jira with proper wiki markup syntax.
## Template
```
h2. Bug Description
[Provide a clear, concise description of the bug]
h3. Environment
* *Browser:* Chrome 120.0
* *OS:* Windows 11
* *Version:* 2.1.0
* *Environment:* Production
h3. Steps to Reproduce
# Navigate to [specific page/feature]
# Perform [specific action]
# Observe [unexpected behavior]
h3. Expected Behavior
[Describe what should happen]
h3. Actual Behavior
[Describe what actually happens]
{panel:title=Error Message|bgColor=#FFEBE9}
{code:java}
[Paste error message or stack trace here]
{code}
{panel}
h3. Additional Context
* Frequency: [Always/Sometimes/Rare]
* User Impact: [Critical/High/Medium/Low]
* Workaround Available: [Yes/No]
h3. Screenshots
[^screenshot1.png]
[^screenshot2.png]
h3. Related Issues
* Blocks [PROJ-XXX]
* Related to [PROJ-YYY]
h3. Technical Notes
{code:javascript}
// Code snippet showing the issue
function problematicCode() {
// Details here
}
{code}
---
*Reported by:* [~username]
*Date:* YYYY-MM-DD
```
## Example - Filled Template
```
h2. Bug Description
Login button becomes unresponsive after failed authentication attempt, requiring page refresh to retry.
h3. Environment
* *Browser:* Chrome 120.0.6099.109
* *OS:* Windows 11
* *Version:* 2.3.1
* *Environment:* Production
h3. Steps to Reproduce
# Navigate to {{/login}} page
# Enter invalid credentials
# Click *Login* button
# Observe error message
# Try to enter correct credentials
# Click *Login* button again
# Button remains disabled
h3. Expected Behavior
After a failed login attempt, the login button should become active again, allowing users to retry with different credentials.
h3. Actual Behavior
The login button remains in a disabled state after the first failed attempt. Users must refresh the page to attempt login again.
{panel:title=Error in Browser Console|bgColor=#FFEBE9}
{code:javascript}
TypeError: Cannot read property 'reset' of null
at LoginForm.handleSubmit (login.js:45)
at onClick (login.js:23)
{code}
{panel}
h3. Additional Context
* Frequency: Always (100% reproduction rate)
* User Impact: High (blocks login functionality)
* Workaround Available: Yes (page refresh)
* Affects ~1000 daily users based on error logs
h3. Screenshots
[^login-disabled-state.png] - Login button stuck in disabled state
[^console-error.png] - Browser console showing error
h3. Related Issues
* Blocks [PROJ-234] - User authentication improvements
* Related to [PROJ-189] - Form validation refactoring
h3. Technical Notes
{code:javascript}
// Problem in LoginForm component
handleSubmit(event) {
event.preventDefault();
this.setState({ isSubmitting: true });
// Error occurs here if form ref is null
this.formRef.reset(); // BUG: formRef can be null
// Rest of submission logic
}
{code}
Suggested fix: Add null check before calling {{reset()}} method.
---
*Reported by:* [~john.smith]
*Date:* 2025-11-06
```
## Usage with jira-communication Skill
```bash
# Create the bug report using the script
uv run scripts/workflow/jira-create.py issue PROJ \
"Login button unresponsive after failed authentication" \
--type Bug \
--priority High \
--labels frontend,authentication,ux \
--description-file bug-description.txt
# Or with inline description (short version)
uv run scripts/workflow/jira-create.py issue PROJ \
"Login button unresponsive after failed authentication" \
--type Bug \
--priority High
```
## Checklist Before Submitting
- [ ] h2. heading for main Description section
- [ ] h3. headings for subsections
- [ ] Numbered list (#) for Steps to Reproduce
- [ ] Bulleted list (*) for Environment details
- [ ] \{panel\} for error messages with appropriate bgColor
- [ ] \{code:language\} for code snippets with correct language
- [ ] [^filename] format for attachment references
- [ ] [PROJ-XXX] format for issue links
- [ ] [~username] format for user mentions
- [ ] *bold* for emphasis on key terms
- [ ] {{monospace}} for UI elements and paths
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |