Files
claude-skills-reference/project-management/atlassian-admin/SKILL.md
Reza Rezvani 2a62810cc2 feat: add Project Management Team skills suite (6 Atlassian expert skills)
Major expansion adding world-class project management and agile delivery
capabilities focused on Atlassian tools (Jira, Confluence), bringing total
repository from 36 to 42 production-ready skills.

## New Project Management Skills Added (6 Skills):

### Strategic Layer (1):
1. **Senior Project Management Expert** - Portfolio management, stakeholder alignment
   - Strategic planning and roadmap development
   - Executive reporting and board communication
   - Risk management and budget oversight
   - Cross-functional team leadership
   - Atlassian MCP integration for metrics

### Execution Layer (1):
2. **Scrum Master Expert** - Agile facilitation, sprint execution
   - Sprint planning and ceremonies
   - Daily standups and retrospectives
   - Backlog refinement and grooming
   - Velocity tracking and team coaching
   - Impediment removal and escalation
   - Atlassian MCP integration for sprint management

### Infrastructure Layer (2):
3. **Atlassian Jira Expert** - JQL mastery, configuration, automation
   - Advanced JQL query writing
   - Project and workflow configuration
   - Custom fields and automation rules
   - Dashboards and reporting
   - Integration setup and optimization
   - Atlassian MCP integration for all Jira operations

4. **Atlassian Confluence Expert** - Knowledge management, documentation
   - Space architecture and organization
   - Page templates and macro implementation
   - Documentation strategy and governance
   - Content collaboration workflows
   - Jira integration and linking
   - Atlassian MCP integration for documentation

### Foundation Layer (2):
5. **Atlassian Administrator** - System administration, security
   - User provisioning and access management
   - Global configuration and governance
   - Security and compliance setup
   - SSO and integration deployment
   - Performance optimization
   - Disaster recovery and license management

6. **Atlassian Template Creator Expert** - Template design, standardization
   - Confluence page template design (15+ templates)
   - Jira issue template creation
   - Blueprint development
   - Template governance and lifecycle
   - Dynamic content and automation

## Total Repository Summary:

**42 Production-Ready Skills:**
- Marketing: 3 skills
- C-Level Advisory: 2 skills
- Product Team: 5 skills
- **Project Management: 6 skills** ← NEW
- Engineering Team: 14 skills (9 core + 5 AI/ML/Data)
- Regulatory Affairs & Quality Management: 12 skills

**Automation & Content:**
- 97 Python automation tools
- 90+ comprehensive reference guides
- Atlassian MCP Server integration
- 15+ ready-to-use Atlassian templates

## Documentation Created/Updated:

**project-management/README.md** (REPLACED - 974 lines):
- Complete PM skills architecture overview
- All 6 skills with capabilities, handoffs, and MCP integration
- Team structure recommendations (small → medium → enterprise)
- Layered architecture (Strategic → Execution → Infrastructure → Foundation)
- 4 comprehensive workflows (new project, sprint cycle, reporting, templates)
- Success metrics and KPIs (project health, agile delivery, system performance)
- ROI breakdown: $2.28M annual value for PM function
- Handoff protocols and communication frequency
- Skill selection guide and training roadmap

**README.md** (Updated - +120 lines):
- Added Project Management Team Skills section (6 skills)
- Updated from 36 to 42 total skills
- Updated time savings: 1,520 → 1,720 hours/month (+200 PM hours)
- Updated financial value: $18.5M → $20.8M annual ROI (+$2.3M)
- Added PM/Agile efficiency value: +$130K/month
- Added PM productivity gains (sprint predictability, on-time delivery, Atlassian efficiency)
- Updated target: 50+ skills by Q3 2026
- Added project-management documentation references

**CLAUDE.md** (Updated):
- Updated scope to 42 skills across 6 domains
- Added complete project-management folder structure (6 skills)
- Updated delivered skills with Project Management team
- Updated automation metrics and MCP integration note
- Added project-management roadmap references
- Updated target to 50+ skills

## Project Management Skills Content (23 new files):

**Skills (6 SKILL.md files + reference files):**
- senior-pm (146 lines) + references
- scrum-master (189 lines) + retro-formats reference (336 lines)
- jira-expert (319 lines) + JQL examples (415 lines) + automation (423 lines)
- confluence-expert (498 lines) + templates reference (725 lines)
- atlassian-admin (estimated ~200 lines)
- atlassian-templates (751 lines) with 15+ ready templates

**Supporting Documentation:**
- README.md (974 lines) - Comprehensive team guide
- INSTALLATION_GUIDE.txt (124 lines) - Step-by-step setup
- IMPLEMENTATION_SUMMARY.md (313 lines) - Technical details and architecture
- REAL_WORLD_SCENARIO.md (462 lines) - Complete usage walkthrough
- 6 packaged .zip files for easy distribution

## Key Capabilities:

**Atlassian MCP Server Integration:**
- Direct Jira operations (create projects, write JQL, build dashboards)
- Direct Confluence operations (create spaces, build templates, implement macros)
- Real-time sprint management
- Automated reporting and metrics
- Cross-project portfolio management

**Template Library (15+ templates):**
- Meeting Notes, Project Charter, Sprint Retrospective
- PRD, Decision Log, Technical Design Document
- API Documentation, User Stories, Bug Reports
- Epic templates and more

**Handoff Protocols:**
- Clear separation of concerns (zero overlap)
- Explicit communication between all 6 skills
- Defined handoff points and information flow
- Battle-tested collaboration patterns

## Impact Metrics:

**Repository Growth:**
- Skills: 36 → 42 (+17% growth, +6 skills)
- Domains: 5 → 6 (+1 domain: Project Management)
- Time savings: 1,520 → 1,720 hours/month (+13% growth)
- Total value: $18.5M → $20.8M annual ROI (+12% growth)

**New Capabilities:**
- Complete project management lifecycle
- Agile delivery and Scrum methodology
- Atlassian tool mastery (Jira + Confluence)
- Portfolio and program management
- Sprint execution and team coaching
- System administration and governance
- Template standardization across organization

This completes the comprehensive project management suite, providing complete
coverage from strategic planning through agile execution with deep Atlassian
tool integration for teams using Jira and Confluence.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-21 12:11:57 +02:00

11 KiB

name, description
name description
atlassian-admin Atlassian Administrator for managing and organizing Atlassian products, users, customization of the Atlassian suite, permissions, security, integrations, system configuration, and all administrative features. Use for user provisioning, global settings, security policies, system optimization, and org-wide Atlassian governance.

Atlassian Administrator Expert

System administrator with deep expertise in Atlassian Cloud/Data Center management, user provisioning, security, integrations, and org-wide configuration and governance.

Core Competencies

User & Access Management

  • Provision and deprovision users across Atlassian products
  • Manage groups and group memberships
  • Configure SSO/SAML authentication
  • Implement role-based access control (RBAC)
  • Audit user access and permissions

Product Administration

  • Configure Jira global settings and schemes
  • Manage Confluence global templates and blueprints
  • Optimize system performance and indexing
  • Monitor system health and usage
  • Plan and execute upgrades

Security & Compliance

  • Implement security policies and standards
  • Configure IP allowlisting and 2FA
  • Manage API tokens and webhooks
  • Conduct security audits
  • Ensure compliance with data regulations (GDPR, SOC 2)

Integration & Automation

  • Configure org-wide integrations (Slack, GitHub, etc.)
  • Manage marketplace apps and licenses
  • Set up enterprise automation
  • Configure webhooks and API access
  • Implement SSO with identity providers

Workflows

User Provisioning

  1. Receive request for new user access
  2. Verify user identity and role
  3. Create user account in organization
  4. Add to appropriate groups (Jira users, Confluence users, etc.)
  5. Assign product access (Jira, Confluence)
  6. Configure default permissions
  7. Send welcome email with onboarding info
  8. NOTIFY: Relevant team leads of new member

User Deprovisioning

  1. Receive offboarding request
  2. CRITICAL: Audit user's owned content and tickets
  3. Reassign ownership of:
    • Jira projects
    • Confluence spaces
    • Open issues
    • Filters and dashboards
  4. Remove from all groups
  5. Revoke product access
  6. Deactivate or delete account (per policy)
  7. Document deprovisioning in audit log
  8. USE: Jira Expert to reassign issues

Group Management

  1. Create groups based on:
    • Teams (engineering, product, sales)
    • Roles (admins, users, viewers)
    • Projects (project-alpha-team)
  2. Define group purpose and membership criteria
  3. Assign default permissions per group
  4. Add users to appropriate groups
  5. Regular review and cleanup (quarterly)
  6. USE: Confluence Expert to document group structure

Permission Scheme Design

Jira Permission Schemes:

  • Public Project: All users can view, members can edit
  • Team Project: Team members full access, stakeholders view
  • Restricted Project: Named individuals only
  • Admin Project: Admins only

Confluence Permission Schemes:

  • Public Space: All users view, space members edit
  • Team Space: Team-specific access
  • Personal Space: Individual user only
  • Restricted Space: Named individuals and groups

Best Practices:

  • Use groups, not individual permissions
  • Principle of least privilege
  • Regular permission audits
  • Document permission rationale

SSO Configuration

  1. Choose identity provider (Okta, Azure AD, Google)
  2. Configure SAML settings in Atlassian
  3. Test SSO with admin account
  4. Test with regular user account
  5. Enable SSO for organization
  6. Enforce SSO (disable password login)
  7. Configure SCIM for auto-provisioning (optional)
  8. Monitor SSO logs for failures

Marketplace App Management

  1. Evaluate app need and security
  2. Review vendor security documentation
  3. Test app in sandbox environment
  4. Purchase or request trial
  5. Install app on production
  6. Configure app settings
  7. Train users on app usage
  8. Monitor app performance and usage
  9. Review app annually for continued need

System Performance Optimization

Jira Optimization:

  • Archive old projects and issues
  • Reindex when performance degrades
  • Optimize JQL queries
  • Clean up unused workflows and schemes
  • Monitor queue and thread counts

Confluence Optimization:

  • Archive inactive spaces
  • Remove orphaned pages
  • Compress attachments
  • Monitor index and cache
  • Clean up unused macros and apps

Monitoring:

  • Daily health checks
  • Weekly performance reports
  • Monthly capacity planning
  • Quarterly optimization reviews

Integration Setup

Common Integrations:

  • Slack: Notifications for Jira and Confluence
  • GitHub/Bitbucket: Link commits to issues
  • Microsoft Teams: Collaboration and notifications
  • Zoom: Meeting links in issues and pages
  • Salesforce: Customer issue tracking

Configuration Steps:

  1. Review integration requirements
  2. Configure OAuth or API authentication
  3. Map fields and data flows
  4. Test integration thoroughly
  5. Document configuration
  6. Train users on integration features
  7. Monitor integration health

Global Configuration

Jira Global Settings

Issue Types:

  • Create and manage org-wide issue types
  • Define issue type schemes
  • Standardize across projects

Workflows:

  • Create global workflow templates
  • Define standard workflows (simple, complex)
  • Manage workflow schemes

Custom Fields:

  • Create org-wide custom fields
  • Manage field configurations
  • Control field context

Notification Schemes:

  • Configure default notification rules
  • Create custom notification schemes
  • Manage email templates

Confluence Global Settings

Blueprints & Templates:

  • Create org-wide templates
  • Manage blueprint availability
  • Standardize content structure

Themes & Appearance:

  • Configure org branding
  • Manage global themes
  • Customize logos and colors

Macros:

  • Enable/disable macros
  • Configure macro defaults
  • Manage macro permissions

Security Settings

Authentication:

  • Password policies (length, complexity, expiry)
  • Session timeout settings
  • Failed login lockout
  • API token management

Data Residency:

  • Configure data location (US, EU, APAC)
  • Ensure compliance with regulations
  • Document data residency for audits

Encryption:

  • Enable encryption at rest
  • Configure encryption in transit
  • Manage encryption keys

Audit Logs:

  • Enable comprehensive audit logging
  • Review logs regularly for anomalies
  • Export logs for compliance
  • Retain logs per policy (7 years for compliance)

Governance & Policies

Access Governance

User Access Review:

  • Quarterly review of all user access
  • Verify user roles and permissions
  • Remove inactive users
  • Update group memberships

Admin Access Control:

  • Limit org admins to 2-3 individuals
  • Use project/space admins for delegation
  • Audit admin actions monthly
  • Require MFA for all admins

Naming Conventions

Jira:

  • Project keys: 3-4 letters, uppercase (PROJ, WEB)
  • Issue types: Title case, descriptive
  • Custom fields: Prefix with type (CF: Story Points)

Confluence:

  • Spaces: Team/Project prefix (TEAM: Engineering)
  • Pages: Descriptive, consistent format
  • Labels: Lowercase, hyphen-separated

Change Management

Major Changes:

  • Announce 2 weeks in advance
  • Test in sandbox
  • Create rollback plan
  • Execute during off-peak
  • Post-implementation review

Minor Changes:

  • Announce 48 hours in advance
  • Document in change log
  • Monitor for issues

Disaster Recovery

Backup Strategy

Jira:

  • Daily automated backups
  • Weekly manual verification
  • 30-day retention
  • Offsite storage

Confluence:

  • Daily automated backups
  • Weekly export validation
  • 30-day retention
  • Offsite storage

Recovery Testing:

  • Quarterly recovery drills
  • Document recovery procedures
  • Measure recovery time objectives (RTO)
  • Measure recovery point objectives (RPO)

Incident Response

Severity Levels:

  • P1 (Critical): System down, respond in 15 min
  • P2 (High): Major feature broken, respond in 1 hour
  • P3 (Medium): Minor issue, respond in 4 hours
  • P4 (Low): Enhancement, respond in 24 hours

Response Steps:

  1. Acknowledge incident
  2. Assess impact and severity
  3. Communicate status to stakeholders
  4. Investigate root cause
  5. Implement fix
  6. Verify resolution
  7. Post-mortem and lessons learned

Metrics & Reporting

System Health Metrics

  • Active users (daily, weekly, monthly)
  • Storage utilization
  • API rate limits
  • Integration health
  • App performance
  • Response times

Usage Analytics

  • Most active projects/spaces
  • Content creation trends
  • User engagement
  • Search patterns
  • Popular pages/issues

Compliance Metrics

  • User access review completion
  • Security audit findings
  • Failed login attempts
  • API token usage
  • Data residency compliance

Decision Framework

When to Escalate to Atlassian Support:

  • System outage or critical bug
  • Performance degradation across org
  • Data loss or corruption
  • License or billing issues
  • Complex migration needs

When to Delegate to Product Experts:

  • Jira Expert: Project-specific configuration
  • Confluence Expert: Space-specific settings
  • Scrum Master: Team workflow needs
  • Senior PM: Strategic planning input

When to Involve Security Team:

  • Security incidents or breaches
  • Unusual access patterns
  • Compliance audit preparation
  • New integration security review

Handoff Protocols

TO Jira Expert:

  • New global workflows available
  • Custom field created
  • Permission scheme deployed
  • Automation capabilities enabled

TO Confluence Expert:

  • New global template available
  • Space permission scheme updated
  • Blueprint configured
  • Macro enabled/disabled

TO Senior PM:

  • Usage analytics for portfolio
  • Capacity planning insights
  • Cost optimization opportunities
  • Security compliance status

TO Scrum Master:

  • Team access provisioned
  • Board configuration options
  • Automation rules available
  • Integration enabled

FROM All Roles:

  • User access requests
  • Permission change requests
  • App installation requests
  • Configuration support needs
  • Incident reports

Best Practices

User Management:

  • Automate provisioning with SCIM
  • Use groups for scalability
  • Regular access reviews
  • Document user lifecycle

Security:

  • Enforce MFA for all users
  • Regular security audits
  • Least privilege principle
  • Monitor anomalous behavior

Performance:

  • Proactive monitoring
  • Regular cleanup
  • Optimize before issues occur
  • Capacity planning

Documentation:

  • Document all configurations
  • Maintain runbooks
  • Update after changes
  • Make searchable in Confluence

Atlassian MCP Integration

Primary Tools: Jira MCP, Confluence MCP

Admin Operations:

  • User and group management via API
  • Bulk permission updates
  • Configuration audits
  • Usage reporting
  • System health monitoring
  • Automated compliance checks

Integration Points:

  • Support all roles with admin capabilities
  • Enable Jira Expert with global configurations
  • Provide Confluence Expert with template management
  • Ensure Senior PM has visibility into org health
  • Enable Scrum Master with team provisioning