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_validator.py
View on GitHub#!/usr/bin/env python3
"""Template Validator - Validate templates against quality standards.
Reads a template and checks it against quality criteria including
structure, instructions, completeness, and maintainability.
Usage:
python template_validator.py --template template.json
python template_validator.py --template template.json --json
python template_validator.py --example
"""
import argparse
import json
import sys
from datetime import datetime
QUALITY_CHECKS = [
{"id": "name", "weight": 10, "description": "Template has a descriptive name (>5 chars)"},
{"id": "owner", "weight": 10, "description": "Template has a designated owner"},
{"id": "description", "weight": 10, "description": "Template has a usage description"},
{"id": "sections", "weight": 15, "description": "Template has 3+ structured sections"},
{"id": "instructions", "weight": 15, "description": "Sections include inline instructions or placeholders"},
{"id": "example", "weight": 10, "description": "A completed example is available"},
{"id": "dynamic", "weight": 10, "description": "Uses dynamic content (macros, dates, Jira queries)"},
{"id": "version", "weight": 5, "description": "Version number is tracked"},
{"id": "freshness", "weight": 10, "description": "Updated within the last 12 months"},
{"id": "labels", "weight": 5, "description": "Template has categorization labels"},
]
def load_data(path: str) -> dict:
with open(path, "r") as f:
return json.load(f)
def validate_template(data: dict) -> dict:
name = data.get("name", "")
results = []
total_weight = 0
earned_weight = 0
# Name check
check = {"id": "name", "weight": 10}
passed = len(name.strip()) > 5
results.append({"check": "name", "passed": passed, "weight": 10, "detail": f"Name: '{name}'"})
total_weight += 10
if passed:
earned_weight += 10
# Owner
passed = bool(data.get("owner", "").strip())
results.append({"check": "owner", "passed": passed, "weight": 10, "detail": f"Owner: {data.get('owner', 'Not set')}"})
total_weight += 10
if passed:
earned_weight += 10
# Description
desc = data.get("description", "")
passed = len(desc.strip()) > 20
results.append({"check": "description", "passed": passed, "weight": 10, "detail": f"Description length: {len(desc)} chars"})
total_weight += 10
if passed:
earned_weight += 10
# Sections
sections = data.get("sections", [])
passed = len(sections) >= 3
results.append({"check": "sections", "passed": passed, "weight": 15, "detail": f"Sections: {len(sections)}"})
total_weight += 15
if passed:
earned_weight += 15
# Instructions
has_instructions = sum(1 for s in sections if s.get("has_instructions", False) or "[" in s.get("content", ""))
passed = has_instructions >= len(sections) * 0.5 if sections else False
results.append({"check": "instructions", "passed": passed, "weight": 15, "detail": f"Sections with instructions: {has_instructions}/{len(sections)}"})
total_weight += 15
if passed:
earned_weight += 15
# Example
passed = data.get("has_example", False)
results.append({"check": "example", "passed": passed, "weight": 10})
total_weight += 10
if passed:
earned_weight += 10
# Dynamic content
passed = data.get("has_dynamic_content", False)
results.append({"check": "dynamic", "passed": passed, "weight": 10})
total_weight += 10
if passed:
earned_weight += 10
# Version
passed = bool(data.get("version", ""))
results.append({"check": "version", "passed": passed, "weight": 5, "detail": f"Version: {data.get('version', 'Not set')}"})
total_weight += 5
if passed:
earned_weight += 5
# Freshness
last_updated = data.get("last_updated", "")
freshness_passed = False
if last_updated:
try:
updated_dt = datetime.strptime(last_updated, "%Y-%m-%d")
# "as_of" in the file pins the reference date so a sample does not age out
as_of = datetime.strptime(data["as_of"], "%Y-%m-%d") if data.get("as_of") else datetime.now()
days = (as_of - updated_dt).days
freshness_passed = days <= 365
except ValueError:
pass
results.append({"check": "freshness", "passed": freshness_passed, "weight": 10, "detail": f"Last updated: {last_updated or 'Unknown'}"})
total_weight += 10
if freshness_passed:
earned_weight += 10
# Labels
labels = data.get("labels", [])
passed = len(labels) >= 1
results.append({"check": "labels", "passed": passed, "weight": 5, "detail": f"Labels: {', '.join(labels) if labels else 'None'}"})
total_weight += 5
if passed:
earned_weight += 5
score = round(earned_weight / total_weight * 100, 1) if total_weight > 0 else 0
if score >= 85:
rating = "Production Ready"
elif score >= 65:
rating = "Needs Minor Fixes"
elif score >= 40:
rating = "Needs Improvement"
else:
rating = "Not Ready"
failures = [r for r in results if not r["passed"]]
recs = []
for f in failures:
check_def = next((c for c in QUALITY_CHECKS if c["id"] == f["check"]), None)
if check_def:
recs.append(f"Fix: {check_def['description']}")
return {
"template_name": name,
"score": score,
"rating": rating,
"checks_passed": sum(1 for r in results if r["passed"]),
"checks_total": len(results),
"results": results,
"recommendations": recs,
}
def print_report(result: dict) -> None:
print(f"\nTemplate Validation: {result['template_name']}")
print("=" * 55)
print(f"Score: {result['score']:.0f}/100 ({result['rating']})")
print(f"Checks: {result['checks_passed']}/{result['checks_total']} passed")
print(f"\nChecks:")
for r in result["results"]:
status = "PASS" if r["passed"] else "FAIL"
detail = f" ({r.get('detail', '')})" if r.get("detail") else ""
check_def = next((c for c in QUALITY_CHECKS if c["id"] == r["check"]), {})
print(f" [{status}] {check_def.get('description', r['check'])}{detail}")
if result["recommendations"]:
print(f"\nActions Needed:")
for i, r in enumerate(result["recommendations"], 1):
print(f" {i}. {r}")
print()
def print_example() -> None:
example = {
"name": "Sprint Retrospective Template",
"owner": "Jane Smith",
"description": "Standard template for sprint retrospective meetings. Covers what went well, challenges, and action items.",
"version": "2.1",
"last_updated": "2026-02-15",
"as_of": "2026-03-21",
"labels": ["sprint", "retro", "agile"],
"has_example": True,
"has_dynamic_content": True,
"sections": [
{"title": "Sprint Overview", "content": "**Sprint**: [Number]\n**Velocity**: [X points]", "has_instructions": True},
{"title": "What Went Well", "content": "- [Positive item]", "has_instructions": True},
{"title": "Challenges", "content": "- [Challenge]", "has_instructions": True},
{"title": "Action Items", "content": "- [ ] [Action] - @owner - [Date]", "has_instructions": True},
],
}
print(json.dumps(example, indent=2))
def main():
parser = argparse.ArgumentParser(description="Validate templates against quality standards.")
parser.add_argument("--template", type=str, help="Path to template JSON file")
parser.add_argument("--json", action="store_true", help="Output as JSON")
parser.add_argument("--example", action="store_true", help="Print example and exit")
args = parser.parse_args()
if args.example:
print_example()
return
if not args.template:
parser.error("--template is required")
data = load_data(args.template)
result = validate_template(data)
if args.json:
print(json.dumps(result, indent=2))
else:
print_report(result)
sys.exit(0 if result["checks_passed"] == result["checks_total"] else 1)
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 |