jira-syntaxlisted
Install: claude install-skill sergeyklay/.agents
# Jira wiki markup
Jira uses its own wiki notation that differs from Markdown in every formatting construct. Agents default to Markdown. Mixing the two produces broken rendering in Jira. This skill ensures correct output.
## Running scripts bundled with this skill
Script paths in this document (e.g. `scripts/`) are resolved relative to **this** SKILL.md file, not to your current working directory. If a relative command fails to resolve, prefix it with the path your platform loaded this SKILL.md from.
**Fallback.** If `python3` cannot be located, analyze the script's purpose and logic and execute its intent with available tools, but warn the user that python is not available and the logic was executed with a fallback approach that may not be perfect.
## Markdown-to-Jira conversion table
These substitutions are mandatory when targeting Jira:
| Concept | Jira wiki markup | NOT Markdown |
|---------|-----------------|--------------|
| Heading | `h2. Title` | `## Title` |
| Bold | `*bold*` | `**bold**` |
| Italic | `_italic_` | `*italic*` |
| Inline code | `{{code}}` | `` `code` `` |
| Code block | `{code:java}...{code}` | ` ```java ``` ` |
| Link | `[text\|url]` | `[text](url)` |
| Issue link | `[PROJ-123]` | n/a |
| User mention | `[~username]` | `@username` |
| Bullet list | `* item` | `- item` |
| Numbered list | `# item` | `1. item` |
| Table header | `\|\|Header\|\|` | `\|Header\|` |
Read `references/syntax-reference.md` for the complete notation including panels, co