borghei/Claude-Skills / project-management/atlassian-templates
atlassian-templates
VerifiedBuilds, validates and retires reusable Jira issue and Confluence page templates. Use when creating a team or org-wide template, a template is ignored or half-filled, or a template library has sprawled. Space layout is confluence-expert.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.7 KB |
| assets/sample_template.json | config | 901 B |
| assets/sample_template_flawed.json | config | 371 B |
| assets/sample_template_spec.json | config | 1.1 KB |
| assets/sample_template_usage.json | config | 950 B |
| examples/unified-prd-epic-story-rollout.md | markdown | 11.5 KB |
| references/confluence-templates.md | markdown | 10.1 KB |
| references/jira-templates.md | markdown | 2.4 KB |
| references/red-flags.md | markdown | 12.9 KB |
| references/troubleshooting.md | markdown | 2.8 KB |
| references/workflows-and-governance.md | markdown | 5.3 KB |
| scripts/template_scaffolder.py | script | 7.6 KB |
| scripts/template_usage_analyzer.py | script | 7.5 KB |
| scripts/template_validator.py | script | 8.3 KB |
scripts/template_scaffolder.py
View on GitHub#!/usr/bin/env python3
"""Template Scaffolder - Generate Confluence/Jira template scaffolds from specs.
Reads a template specification and generates ready-to-deploy Confluence
storage format or Jira description markup.
Usage:
python template_scaffolder.py --spec spec.json --format confluence
python template_scaffolder.py --spec spec.json --format jira --json
python template_scaffolder.py --example
"""
import argparse
import json
import sys
CONFLUENCE_SECTION_TEMPLATES = {
"header_panel": '{panel:title=__TITLE__|borderColor=#0052cc}\n__CONTENT__\n{panel}\n',
"info_block": '{info}\n__CONTENT__\n{info}\n',
"warning_block": '{warning}\n__CONTENT__\n{warning}\n',
"table": '| __HEADERS__ |\n| __SEPARATOR__ |\n| __ROWS__ |\n',
"task_list": '{tasks}\n__ITEMS__\n{tasks}\n',
"expand": '{expand:title=__TITLE__}\n__CONTENT__\n{expand}\n',
"heading": 'h__LEVEL__. __TITLE__\n',
"toc": '{toc:maxLevel=3}\n',
}
def load_data(path: str) -> dict:
with open(path, "r") as f:
return json.load(f)
def generate_confluence(spec: dict) -> str:
"""Generate Confluence storage format template."""
name = spec.get("name", "Untitled Template")
sections = spec.get("sections", [])
metadata = spec.get("metadata", {})
output = []
# Header panel
meta_lines = []
for key, value in metadata.items():
meta_lines.append(f"**{key}**: {value}")
if meta_lines:
panel = CONFLUENCE_SECTION_TEMPLATES["header_panel"]
panel = panel.replace("__TITLE__", name)
panel = panel.replace("__CONTENT__", "\n".join(meta_lines))
output.append(panel)
# TOC
if spec.get("include_toc", True):
output.append(CONFLUENCE_SECTION_TEMPLATES["toc"])
# Sections
for section in sections:
sec_type = section.get("type", "heading")
title = section.get("title", "Section")
content = section.get("content", "[Add content here]")
level = section.get("level", 2)
if sec_type == "heading":
heading = CONFLUENCE_SECTION_TEMPLATES["heading"]
heading = heading.replace("__LEVEL__", str(level))
heading = heading.replace("__TITLE__", title)
output.append(heading)
output.append(content + "\n")
elif sec_type == "table":
headers = section.get("headers", ["Column 1", "Column 2"])
rows = section.get("rows", 3)
heading = CONFLUENCE_SECTION_TEMPLATES["heading"].replace("__LEVEL__", str(level)).replace("__TITLE__", title)
output.append(heading)
header_row = " | ".join(headers)
separator = " | ".join(["---"] * len(headers))
row_template = " | ".join(["[Enter value]"] * len(headers))
row_lines = "\n".join([f"| {row_template} |"] * rows)
output.append(f"| {header_row} |\n| {separator} |\n{row_lines}\n")
elif sec_type == "task_list":
heading = CONFLUENCE_SECTION_TEMPLATES["heading"].replace("__LEVEL__", str(level)).replace("__TITLE__", title)
output.append(heading)
items = section.get("items", ["Task 1", "Task 2", "Task 3"])
item_lines = "\n".join([f"- [ ] {item}" for item in items])
tasks = CONFLUENCE_SECTION_TEMPLATES["task_list"].replace("__ITEMS__", item_lines)
output.append(tasks)
elif sec_type == "expand":
expand = CONFLUENCE_SECTION_TEMPLATES["expand"]
expand = expand.replace("__TITLE__", title)
expand = expand.replace("__CONTENT__", content)
output.append(expand)
elif sec_type == "info":
heading = CONFLUENCE_SECTION_TEMPLATES["heading"].replace("__LEVEL__", str(level)).replace("__TITLE__", title)
output.append(heading)
info = CONFLUENCE_SECTION_TEMPLATES["info_block"].replace("__CONTENT__", content)
output.append(info)
return "\n".join(output)
def generate_jira(spec: dict) -> str:
"""Generate Jira description template."""
name = spec.get("name", "Untitled")
sections = spec.get("sections", [])
output = []
for section in sections:
title = section.get("title", "Section")
content = section.get("content", "[Add details]")
sec_type = section.get("type", "heading")
output.append(f"## {title}")
if sec_type == "table":
headers = section.get("headers", ["Column 1", "Column 2"])
output.append("| " + " | ".join(headers) + " |")
output.append("| " + " | ".join(["---"] * len(headers)) + " |")
for _ in range(section.get("rows", 2)):
output.append("| " + " | ".join([""] * len(headers)) + " |")
elif sec_type == "task_list":
items = section.get("items", ["Item 1", "Item 2"])
for item in items:
output.append(f"- [ ] {item}")
else:
output.append(content)
output.append("")
return "\n".join(output)
def scaffold_template(spec: dict, fmt: str) -> dict:
if fmt == "confluence":
content = generate_confluence(spec)
else:
content = generate_jira(spec)
return {
"name": spec.get("name", "Untitled"),
"format": fmt,
"section_count": len(spec.get("sections", [])),
"content": content,
}
def print_report(result: dict) -> None:
print(f"\nTemplate Scaffold: {result['name']}")
print(f"Format: {result['format']} | Sections: {result['section_count']}")
print("=" * 60)
print(result["content"])
def print_example() -> None:
example = {
"name": "Sprint Retrospective",
"include_toc": True,
"metadata": {
"Sprint": "[Sprint Number]",
"Date": "{date}",
"Team": "[Team Name]",
"Facilitator": "@facilitator",
},
"sections": [
{"type": "heading", "title": "Sprint Overview", "level": 2, "content": "**Sprint Goal**: [Goal]\n**Velocity**: [X points]\n**Completed**: [X/Y stories]"},
{"type": "heading", "title": "What Went Well", "level": 2, "content": "- [Positive item 1]\n- [Positive item 2]"},
{"type": "heading", "title": "What Needs Improvement", "level": 2, "content": "- [Challenge 1]\n- [Challenge 2]"},
{"type": "table", "title": "Improvement Ideas", "level": 2, "headers": ["Idea", "Votes", "Owner", "Target Sprint"], "rows": 3},
{"type": "task_list", "title": "Action Items", "level": 2, "items": ["Action 1 - @owner - Due: [Date]", "Action 2 - @owner - Due: [Date]"]},
],
}
print(json.dumps(example, indent=2))
def main():
parser = argparse.ArgumentParser(description="Generate Confluence/Jira template scaffolds.")
parser.add_argument("--spec", type=str, help="Path to template spec JSON file")
parser.add_argument("--format", choices=["confluence", "jira"], default="confluence", help="Output format")
parser.add_argument("--json", action="store_true", help="Output as JSON")
parser.add_argument("--example", action="store_true", help="Print example spec and exit")
args = parser.parse_args()
if args.example:
print_example()
return
if not args.spec:
parser.error("--spec is required")
spec = load_data(args.spec)
result = scaffold_template(spec, args.format)
if args.json:
print(json.dumps(result, indent=2))
else:
print_report(result)
if __name__ == "__main__":
try:
main()
except (OSError, ValueError, KeyError, TypeError, AttributeError, IndexError) as exc:
print(f"error: bad input ({type(exc).__name__}): {exc}", file=sys.stderr)
sys.exit(2)
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 |