# 075 Agents 6a081156

> <!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-12-12 -->

- Skill: `tools-only/075-agents-6a081156` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/075-agents-6a081156`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/075-agents-6a081156/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/075-agents-6a081156

---

<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-12-12 -->

# AGENTS.md — jira-syntax

Development guide for maintaining templates, references, and validation scripts.

## Overview

Static content skill: templates, reference docs, and a validation script. No runtime dependencies.

## Setup & environment

No special setup. Files are plain text/markdown/shell.

## Build & tests

```bash
# Test validation script
scripts/validate-jira-syntax.sh templates/bug-report-template.md
```

## Code style & conventions

**Templates (`templates/`):**
- Use actual Jira wiki markup, never Markdown
- Include section comments explaining purpose
- Test in real Jira before committing

**References (`references/`):**
- Keep `jira-syntax-quick-reference.md` as single source of truth
- Examples must be copy-pasteable into Jira

**Validation script:**
- Bash with grep patterns
- Should catch common Markdown mistakes

## Security & safety

- No executable code in templates
- No sensitive data in examples

## PR/commit checklist

- [ ] All examples use valid Jira wiki markup
- [ ] Tested in actual Jira instance
- [ ] Updated quick-reference if adding new syntax
- [ ] Validation script catches the patterns

## Good vs. bad examples

**Template changes:**
```
# ✓ Test paste into Jira before commit
# ✓ Update quick-reference if new syntax

# ✗ Assume Markdown works in Jira
# ✗ Add syntax without testing
```

## When stuck

- Paste content into real Jira to verify rendering
- Check official docs: https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa

## House rules

- SKILL.md has the user-facing syntax reference
- This file is for maintaining the skill itself

---

**Maintaining this file:** See root `AGENTS.md` for convention reference.