PromptShop

Atlassian Templates

This skill specializes in creating, modifying, and managing reusable templates and files for Jira and Confluence.

Install

npx promptshop add atlassian-templates

Details

What This Skill Does

This skill specializes in creating, modifying, and managing reusable templates and files for Jira and Confluence. It helps maintain consistency, accelerates content creation, and enforces organization-wide standards. It is useful for documentation teams, project managers, and Atlassian administrators.

When to Use

  • Create a new template for meeting notes in Confluence.
  • Modify an existing Jira issue template.
  • Deploy a template to a specific Confluence space.
  • Train users on how to use a new template.
  • Develop a blueprint for a multi-page Confluence structure.
  • Migrate existing content to a new template version.

Key Features

  • Creates and manages reusable templates for Jira and Confluence.
  • Supports template versioning and migration.
  • Integrates with the Confluence MCP Server.
  • Provides a structured template creation process.
  • Offers blueprint development for complex page structures.
  • Includes testing and documentation steps.

Manual Installation

Workflows

Template Creation Process

  • Discover: Interview stakeholders to understand needs
  • Analyze: Review existing content patterns
  • Design: Create template structure and placeholders
  • Implement: Build template with macros and formatting
  • Test: Validate with sample data — confirm template renders correctly in preview before publishing
  • Document: Create usage instructions
  • Publish: Deploy to appropriate space/project via MCP (see MCP Operations below)
  • Verify: Confirm deployment success; roll back to previous version if errors occur
  • Train: Educate users on template usage
  • Monitor: Track adoption and gather feedback
  • Iterate: Refine based on usage

Template Modification Process

  • Assess: Review change request and impact
  • Version: Create new version, keep old available
  • Modify: Update template structure/content
  • Test: Validate changes don't break existing usage; preview updated template before publishing
  • Migrate: Provide migration path for existing content
  • Communicate: Announce changes to users
  • Support: Assist users with migration
  • Archive: Deprecate old version after transition; confirm deprecated template is unlisted, not deleted

Blueprint Development

  • Define blueprint scope and purpose.
  • Design multi-page structure.
  • Create page templates for each section.
  • Configure page creation rules.
  • Add dynamic content (Jira queries, user data)
  • Test blueprint creation flow end-to-end with a sample space.
  • Verify all macro references resolve correctly before deployment.
  • HANDOFF TO: Atlassian Admin for global deployment

Confluence Templates Library

See TEMPLATES.md for full reference tables and copy-paste-ready template structures. The following summarises the standard types this skill creates and maintains.

Confluence Template Types

TemplatePurposeKey Macros Used
Meeting NotesStructured meeting records with agenda, decisions, and action items{date}, {tasks}, {panel}, {info}, {note}
Project CharterOrg-level project scope, stakeholder RACI, timeline, and budget{panel}, {status}, {timeline}, {info}
Sprint RetrospectiveAgile ceremony template with What Went Well / Didn't Go Well / Actions{panel}, {expand}, {tasks}, {status}
PRDFeature definition with goals, user stories, functional/non-functional requirements, and release plan{panel}, {status}, {jira}, {warning}
Decision LogStructured option analysis with decision matrix and implementation tracking{panel}, {status}, {info}, {tasks}
  • Standard Sections included across all Confluence templates:
  • Header panel with metadata (owner, date, status)
  • Clearly labelled content sections with inline placeholder instructions.
  • Action items block using {tasks} macro.
  • Related links and references.

Complete Example: Meeting Notes Template

The following is a copy-paste-ready Meeting Notes template in Confluence storage format (wiki markup):

{panel:title=Meeting Metadata|borderColor=#0052CC|titleBGColor=#0052CC|titleColor=#FFFFFF} Date: {date} Owner / Facilitator: @[facilitator name] Attendees: @[name], @[name] Status: {status:colour=Yellow|title=In Progress} {panel}

h2. Agenda [Agenda item 1] [Agenda item 2] [Agenda item 3]

h2. Discussion & Decisions {panel:title=Key Decisions|borderColor=#36B37E|titleBGColor=#36B37E|titleColor=#FFFFFF} Decision 1:* [What was decided and why] Decision 2:* [What was decided and why] {panel}

{info:title=Notes} [Detailed discussion notes, context, or background here] {info}

h2. Action Items {tasks}

  • [Action item] — Owner: @[name] — Due: {date} {tasks}

h2. Next Steps & Related Links

  • Next meeting: {date}
  • Related pages: [link]
  • Related Jira issues: {jira:key=PROJ-123}

Full examples for all other template types (Project Charter, Sprint Retrospective, PRD, Decision Log) and all Jira templates can be generated on request or found in TEMPLATES.md.

Jira Templates Library

Jira Template Types

TemplatePurposeKey Sections
User StoryFeature requests in As a / I want / So that formatAcceptance Criteria (Given/When/Then), Design links, Technical Notes, Definition of Done
Bug ReportDefect capture with reproduction stepsEnvironment, Steps to Reproduce, Expected vs Actual Behavior, Severity, Workaround
EpicHigh-level initiative scopeVision, Goals, Success Metrics, Story Breakdown, Dependencies, Timeline

Standard Sections included across all Jira templates: Clear summary line

  • Acceptance or success criteria as checkboxes.
  • Related issues and dependencies block.
  • Definition of Done (for stories)

Macro Usage Guidelines

  • Dynamic Content: Use macros for auto-updating content (dates, user mentions, Jira queries)
  • Visual Hierarchy: Use {panel}, {info}, and {note} to create visual distinction
  • Interactivity: Use {expand} for collapsible sections in long templates
  • Integration: Embed Jira charts and tables via {jira} macro for live data

Atlassian MCP Integration

Primary Tools: Confluence MCP, Jira MCP

Template Operations via MCP

All MCP calls below use the exact parameter names expected by the Atlassian MCP server. Replace angle-bracket placeholders with real values before executing.

Create a Confluence page template: { "tool": "confluence_create_page", "parameters": { "space_key": "PROJ", "title": "Template: Meeting Notes", "body": "<storage-format template content>", "labels": ["template", "meeting-notes"], "parent_id": "<optional parent page id>" } }

Update an existing template: { "tool": "confluence_update_page", "parameters": { "page_id": "<existing page id>", "version": "<current_version + 1>", "title": "Template: Meeting Notes", "body": "<updated storage-format content>", "version_comment": "v2 — added status macro to header" } }

Create a Jira issue description template (via field configuration): { "tool": "jira_update_field_configuration", "parameters": { "project_key": "PROJ", "field_id": "description", "default_value": "<template markdown or Atlassian Document Format JSON>" } }

Deploy template to multiple spaces (batch): // Repeat for each target space key { "tool": "confluence_create_page", "parameters": { "space_key": "<SPACE_KEY>", "title": "Template: Meeting Notes", "body": "<storage-format template content>", "labels": ["template"] } } // After each create, verify: { "tool": "confluence_get_page", "parameters": { "space_key": "<SPACE_KEY>", "title": "Template: Meeting Notes" } } // Assert response status == 200 and page body is non-empty before proceeding to next space

V